Libc-1439.100.3.tar.gz

[apple/libc.git] / stdio / FreeBSD / putwc.3

diff --git a/stdio/FreeBSD/putwc.3 b/stdio/FreeBSD/putwc.3
index b117a04b45b8ebac753e73063ed7e22ca1e79bc3..84799bccbc9db3d9d620d76e263091cfabc4540a 100644 (file)
--- a/stdio/FreeBSD/putwc.3
+++ b/stdio/FreeBSD/putwc.3
@@ -15,10 +15,6 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.

-.\" 3. All advertising materials mentioning features or use of this software
-.\"    must display the following acknowledgement:
-.\"    This product includes software developed by the University of
-.\"    California, Berkeley and its contributors.

 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.


@@ -36,32 +32,40 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)putc.3     8.1 (Berkeley) 6/4/93
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)putc.3     8.1 (Berkeley) 6/4/93

-.\" $FreeBSD: src/lib/libc/stdio/putwc.3,v 1.6 2002/12/04 18:57:45 ru Exp $
+.\" $FreeBSD: src/lib/libc/stdio/putwc.3,v 1.8 2007/01/09 00:28:07 imp Exp $

 .\"
 .\"

-.Dd October 10, 2002
+.Dd March 3, 2004

 .Dt PUTWC 3
 .Os
 .Sh NAME
 .Nm fputwc ,
 .Nm putwc ,
 .Nm putwchar
 .Dt PUTWC 3
 .Os
 .Sh NAME
 .Nm fputwc ,
 .Nm putwc ,
 .Nm putwchar

-.Nd output a wide-character to a stream
+.Nd output a wide character to a stream

 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In stdio.h
 .In wchar.h
 .Ft wint_t
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In stdio.h
 .In wchar.h
 .Ft wint_t

-.Fn fputwc "wchar_t wc" "FILE *stream"
+.Fo fputwc
+.Fa "wchar_t wc"
+.Fa "FILE *stream"
+.Fc

 .Ft wint_t
 .Ft wint_t

-.Fn putwc "wchar_t wc" "FILE *stream"
+.Fo putwc
+.Fa "wchar_t wc"
+.Fa "FILE *stream"
+.Fc

 .Ft wint_t
 .Ft wint_t

-.Fn putwchar "wchar_t wc"
+.Fo putwchar
+.Fa "wchar_t wc"
+.Fc

 .Sh DESCRIPTION
 The
 .Fn fputwc
 function
 .Sh DESCRIPTION
 The
 .Fn fputwc
 function

-writes the wide-character
+writes the wide character

 .Fa wc
 to the output stream pointed to by
 .Fa stream .
 .Fa wc
 to the output stream pointed to by
 .Fa stream .


@@ -79,6 +83,12 @@ is identical to
 .Fn putwc
 with an output stream of
 .Dv stdout .
 .Fn putwc
 with an output stream of
 .Dv stdout .

+.Pp
+Extended locale versions of these functions are documented in
+.Xr putwc_l 3 .
+See
+.Xr xlocale 3
+for more information.

 .Sh RETURN VALUES
 The
 .Fn fputwc ,
 .Sh RETURN VALUES
 The
 .Fn fputwc ,


@@ -86,7 +96,7 @@ The
 and
 .Fn putwchar
 functions
 and
 .Fn putwchar
 functions

-return the wide-character written.
+return the wide character written.

 If an error occurs, the value
 .Dv WEOF
 is returned.
 If an error occurs, the value
 .Dv WEOF
 is returned.


@@ -95,6 +105,7 @@ is returned.
 .Xr fopen 3 ,
 .Xr getwc 3 ,
 .Xr putc 3 ,
 .Xr fopen 3 ,
 .Xr getwc 3 ,
 .Xr putc 3 ,

+.Xr putwc_l 3 ,

 .Xr stdio 3
 .Sh STANDARDS
 The
 .Xr stdio 3
 .Sh STANDARDS
 The