stdio/FreeBSD/fgetws.3.patch

   1 --- fgetws.3.orig       Fri Mar 11 11:51:15 2005
   2 +++ fgetws.3    Fri Mar 11 11:52:41 2005
   3 @@ -41,7 +41,8 @@
   4  .Dt FGETWS 3
   5  .Os
   6  .Sh NAME
   7 -.Nm fgetws
   8 +.Nm fgetws ,
   9 +.Nm fgetws_l
  10  .Nd get a line of wide characters from a stream
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -50,6 +51,9 @@
  14  .In wchar.h
  15  .Ft "wchar_t *"
  16  .Fn fgetws "wchar_t * restrict ws" "int n" "FILE * restrict fp"
  17 +.In xlocale.h
  18 +.Ft "wchar_t *"
  19 +.Fn fgetws_l "wchar_t * restrict ws" "int n" "FILE * restrict fp" "locale_t loc"
  20  .Sh DESCRIPTION
  21  The
  22  .Fn fgetws
  23 @@ -66,6 +70,14 @@
  24  If any characters are read and there is no error, a
  25  .Ql \e0
  26  character is appended to end the string.
  27 +.Pp
  28 +While the
  29 +.Fn fgetws
  30 +function uses the current locale, the
  31 +.Fn fgetws_l
  32 +function may be passed a locale directly. See
  33 +.Xr xlocale 3
  34 +for more information.
  35  .Sh RETURN VALUES
  36  Upon successful completion,
  37  .Fn fgetws
  38 @@ -116,7 +128,8 @@
  39  .Sh SEE ALSO
  40  .Xr feof 3 ,
  41  .Xr ferror 3 ,
  42 -.Xr fgets 3
  43 +.Xr fgets 3 ,
  44 +.Xr xlocale 3
  45  .Sh STANDARDS
  46  The
  47  .Fn fgetws