stdio/FreeBSD/fgetwln.3.patch

   1 --- fgetwln.3.orig      2009-10-29 11:41:29.000000000 -0700
   2 +++ fgetwln.3   2009-10-29 11:44:37.000000000 -0700
   3 @@ -32,7 +32,8 @@
   4  .Dt FGETWLN 3
   5  .Os
   6  .Sh NAME
   7 -.Nm fgetwln
   8 +.Nm fgetwln ,
   9 +.Nm fgetwln_l
  10  .Nd get a line of wide characters from a stream
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -41,6 +42,9 @@
  14  .In wchar.h
  15  .Ft wchar_t *
  16  .Fn fgetwln "FILE * restrict stream" "size_t * restrict len"
  17 +.In xlocale.h
  18 +.Ft wchar_t *
  19 +.Fn fgetwln_l "FILE * restrict stream" "size_t * restrict len" "locale_t loc"
  20  .Sh DESCRIPTION
  21  The
  22  .Fn fgetwln
  23 @@ -58,6 +62,14 @@ points.
  24  (Note, however, that if the line is the last
  25  in a file that does not end in a newline,
  26  the returned text will not contain a newline.)
  27 +.Pp
  28 +While the
  29 +.Fn fgetwln
  30 +function uses the current locale, the
  31 +.Fn fgetwln_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 a pointer is returned;
  37  this pointer becomes invalid after the next
  38 @@ -113,4 +125,5 @@ or
  39  .Xr ferror 3 ,
  40  .Xr fgetln 3 ,
  41  .Xr fgetws 3 ,
  42 -.Xr fopen 3
  43 +.Xr fopen 3 ,
  44 +.Xr xlocale 3