stdio/FreeBSD/fputws.3.patch

   1 --- fputws.3.bsdnew     2009-11-11 13:33:08.000000000 -0800
   2 +++ fputws.3    2009-11-11 13:33:08.000000000 -0800
   3 @@ -37,7 +37,8 @@
   4  .Dt FPUTWS 3
   5  .Os
   6  .Sh NAME
   7 -.Nm fputws
   8 +.Nm fputws ,
   9 +.Nm fputws_l
  10  .Nd output a line of wide characters to a stream
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -45,14 +46,34 @@
  14  .In stdio.h
  15  .In wchar.h
  16  .Ft int
  17 -.Fn fputws "const wchar_t * restrict ws" "FILE * restrict fp"
  18 +.Fo fputws
  19 +.Fa "const wchar_t *restrict ws"
  20 +.Fa "FILE *restrict stream"
  21 +.Fc
  22 +.In stdio.h
  23 +.In wchar.h
  24 +.In xlocale.h
  25 +.Ft int
  26 +.Fo fputws_l
  27 +.Fa "const wchar_t *restrict ws"
  28 +.Fa "FILE *restrict stream"
  29 +.Fa "locale_t loc"
  30 +.Fc
  31  .Sh DESCRIPTION
  32  The
  33  .Fn fputws
  34  function writes the wide character string pointed to by
  35  .Fa ws
  36  to the stream pointed to by
  37 -.Fa fp .
  38 +.Fa stream .
  39 +.Pp
  40 +Although the
  41 +.Fn fputws
  42 +function uses the current locale, the
  43 +.Fn fputws_l
  44 +function may be passed a locale directly. See
  45 +.Xr xlocale 3
  46 +for more information.
  47  .Sh RETURN VALUES
  48  The
  49  .Fn fputws
  50 @@ -65,7 +86,7 @@ function will fail if:
  51  .Bl -tag -width Er
  52  .It Bq Er EBADF
  53  The
  54 -.Fa fp
  55 +.Fa stream
  56  argument supplied
  57  is not a writable stream.
  58  .El
  59 @@ -80,7 +101,8 @@ for any of the errors specified for the
  60  .Xr ferror 3 ,
  61  .Xr fputs 3 ,
  62  .Xr putwc 3 ,
  63 -.Xr stdio 3
  64 +.Xr stdio 3 ,
  65 +.Xr xlocale 3
  66  .Sh STANDARDS
  67  The
  68  .Fn fputws