locale/FreeBSD/mbrtowc.3.patch

   1 --- mbrtowc.3.orig      Fri Mar 11 19:44:47 2005
   2 +++ mbrtowc.3   Fri Mar 11 19:55:59 2005
   3 @@ -28,7 +28,8 @@
   4  .Dt MBRTOWC 3
   5  .Os
   6  .Sh NAME
   7 -.Nm mbrtowc
   8 +.Nm mbrtowc ,
   9 +.Nm mbrtowc_l
  10  .Nd "convert a character to a wide-character code (restartable)"
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -39,6 +40,12 @@
  14  .Fa "wchar_t * restrict pwc" "const char * restrict s" "size_t n"
  15  .Fa "mbstate_t * restrict ps"
  16  .Fc
  17 +.In xlocale.h
  18 +.Ft size_t
  19 +.Fo mbrtowc_l
  20 +.Fa "wchar_t * restrict pwc" "const char * restrict s" "size_t n"
  21 +.Fa "mbstate_t * restrict ps" "locale_t loc"
  22 +.Fc
  23  .Sh DESCRIPTION
  24  The
  25  .Fn mbrtowc
  26 @@ -86,6 +93,14 @@
  27  .Vt mbstate_t
  28  object, which is initialized to the initial conversion state
  29  at program startup.
  30 +.Pp
  31 +While the
  32 +.Fn mbrtowc
  33 +function uses the current locale, the
  34 +.Fn mbrtowc_l
  35 +function may be passed a locale directly. See
  36 +.Xr xlocale 3
  37 +for more information.
  38  .Sh RETURN VALUES
  39  The
  40  .Fn mbrtowc
  41 @@ -131,7 +146,8 @@
  42  .Xr mbtowc 3 ,
  43  .Xr multibyte 3 ,
  44  .Xr setlocale 3 ,
  45 -.Xr wcrtomb 3
  46 +.Xr wcrtomb 3 ,
  47 +.Xr xlocale 3
  48  .Sh STANDARDS
  49  The
  50  .Fn mbrtowc