locale/FreeBSD/mbtowc.3.patch

   1 --- mbtowc.3.orig       Fri Mar 11 19:44:47 2005
   2 +++ mbtowc.3    Fri Mar 11 19:54:09 2005
   3 @@ -41,7 +41,8 @@
   4  .Dt MBTOWC 3
   5  .Os
   6  .Sh NAME
   7 -.Nm mbtowc
   8 +.Nm mbtowc ,
   9 +.Nm mbtowc_l
  10  .Nd convert a character to a wide-character code
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -52,6 +53,12 @@
  14  .Fa "wchar_t * restrict wcharp" "const char * restrict mbchar"
  15  .Fa "size_t nbytes"
  16  .Fc
  17 +.In xlocale.h
  18 +.Ft int
  19 +.Fo mbtowc_l
  20 +.Fa "wchar_t * restrict wcharp" "const char * restrict mbchar"
  21 +.Fa "size_t nbytes" "locale_t loc"
  22 +.Fc
  23  .Sh DESCRIPTION
  24  The
  25  .Fn mbtowc
  26 @@ -70,6 +77,14 @@
  27  pointer returns nonzero if the current encoding requires shift states,
  28  zero otherwise;
  29  if shift states are required, the shift state is reset to the initial state.
  30 +.Pp
  31 +While the
  32 +.Fn mbtowc
  33 +function uses the current locale, the
  34 +.Fn mbtowc_l
  35 +function may be passed a locale directly. See
  36 +.Xr xlocale 3
  37 +for more information.
  38  .Sh RETURN VALUES
  39  If
  40  .Fa mbchar
  41 @@ -110,7 +125,8 @@
  42  .Xr mbrtowc 3 ,
  43  .Xr mbstowcs 3 ,
  44  .Xr multibyte 3 ,
  45 -.Xr wctomb 3
  46 +.Xr wctomb 3 ,
  47 +.Xr xlocale 3
  48  .Sh STANDARDS
  49  The
  50  .Fn mbtowc