locale/FreeBSD/wcrtomb.3.patch

   1 --- wcrtomb.3.orig      Fri Mar 11 19:44:47 2005
   2 +++ wcrtomb.3   Fri Mar 11 19:49:35 2005
   3 @@ -28,7 +28,8 @@
   4  .Dt WCRTOMB 3
   5  .Os
   6  .Sh NAME
   7 -.Nm wcrtomb
   8 +.Nm wcrtomb ,
   9 +.Nm wcrtomb_l
  10  .Nd "convert a wide-character code to a character (restartable)"
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -36,6 +37,9 @@
  14  .In wchar.h
  15  .Ft size_t
  16  .Fn wcrtomb "char * restrict s" "wchar_t wc" "mbstate_t * restrict ps"
  17 +.In xlocale.h
  18 +.Ft size_t
  19 +.Fn wcrtomb_l "char * restrict s" "wchar_t wc" "mbstate_t * restrict ps" "locale_t loc"
  20  .Sh DESCRIPTION
  21  The
  22  .Fn wcrtomb
  23 @@ -72,6 +76,14 @@
  24  .Vt mbstate_t
  25  object, which is initialized to the initial conversion state
  26  at program startup.
  27 +.Pp
  28 +While the
  29 +.Fn wcrtomb
  30 +function uses the current locale, the
  31 +.Fn wcrtomb_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 wcrtomb
  38 @@ -97,7 +109,8 @@
  39  .Xr mbrtowc 3 ,
  40  .Xr multibyte 3 ,
  41  .Xr setlocale 3 ,
  42 -.Xr wctomb 3
  43 +.Xr wctomb 3 ,
  44 +.Xr xlocale 3
  45  .Sh STANDARDS
  46  The
  47  .Fn wcrtomb