locale/FreeBSD/wctomb.3.patch

   1 --- wctomb.3.orig       Fri Mar 11 19:44:47 2005
   2 +++ wctomb.3    Fri Mar 11 19:47:38 2005
   3 @@ -41,7 +41,8 @@
   4  .Dt WCTOMB 3
   5  .Os
   6  .Sh NAME
   7 -.Nm wctomb
   8 +.Nm wctomb ,
   9 +.Nm wctomb_l
  10  .Nd convert a wide-character code to a character
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -49,6 +50,9 @@
  14  .In stdlib.h
  15  .Ft int
  16  .Fn wctomb "char *mbchar" "wchar_t wchar"
  17 +.In xlocale.h
  18 +.Ft int
  19 +.Fn wctomb_l "char *mbchar" "wchar_t wchar" "locale_t loc"
  20  .Sh DESCRIPTION
  21  The
  22  .Fn wctomb
  23 @@ -69,6 +73,14 @@
  24  pointer returns nonzero if the current locale requires shift states,
  25  zero otherwise;
  26  if shift states are required, the shift state is reset to the initial state.
  27 +.Pp
  28 +While the
  29 +.Fn wctomb
  30 +function uses the current locale, the
  31 +.Fn wctomb_l
  32 +function may be passed a locale directly. See
  33 +.Xr xlocale 3
  34 +for more information.
  35  .Sh RETURN VALUES
  36  If
  37  .Fa mbchar
  38 @@ -104,7 +116,8 @@
  39  .Xr mbtowc 3 ,
  40  .Xr wcrtomb 3 ,
  41  .Xr wcstombs 3 ,
  42 -.Xr wctob 3
  43 +.Xr wctob 3 ,
  44 +.Xr xlocale 3
  45  .Sh STANDARDS
  46  The
  47  .Fn wctomb