stdio/FreeBSD/ungetwc.3.patch

   1 --- ungetwc.3.orig      Fri Mar 11 11:54:47 2005
   2 +++ ungetwc.3   Fri Mar 11 11:55:38 2005
   3 @@ -42,7 +42,8 @@
   4  .Dt UNGETWC 3
   5  .Os
   6  .Sh NAME
   7 -.Nm ungetwc
   8 +.Nm ungetwc ,
   9 +.Nm ungetwc_l
  10  .Nd un-get wide character from input stream
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -51,6 +52,9 @@
  14  .In wchar.h
  15  .Ft wint_t
  16  .Fn ungetwc "wint_t wc" "FILE *stream"
  17 +.In xlocale.h
  18 +.Ft wint_t
  19 +.Fn ungetwc_l "wint_t wc" "FILE *stream" "locale_t loc"
  20  .Sh DESCRIPTION
  21  The
  22  .Fn ungetwc
  23 @@ -76,6 +80,14 @@
  24  .Pp
  25  If a character is successfully pushed-back,
  26  the end-of-file indicator for the stream is cleared.
  27 +.Pp
  28 +While the
  29 +.Fn ungetwc
  30 +function uses the current locale, the
  31 +.Fn ungetwc_l
  32 +function may be passed a locale directly. See
  33 +.Xr xlocale 3
  34 +for more information.
  35  .Sh RETURN VALUES
  36  The
  37  .Fn ungetwc
  38 @@ -91,7 +103,8 @@
  39  the operation will fail and the stream will remain unchanged.
  40  .Sh SEE ALSO
  41  .Xr fseek 3 ,
  42 -.Xr getwc 3
  43 +.Xr getwc 3 ,
  44 +.Xr xlocale 3
  45  .Sh STANDARDS
  46  The
  47  .Fn ungetwc