locale/FreeBSD/wcstombs.3.patch

   1 --- wcstombs.3.orig     Fri Mar 11 19:44:47 2005
   2 +++ wcstombs.3  Fri Mar 11 19:48:16 2005
   3 @@ -41,7 +41,8 @@
   4  .Dt WCSTOMBS 3
   5  .Os
   6  .Sh NAME
   7 -.Nm wcstombs
   8 +.Nm wcstombs ,
   9 +.Nm wcstombs_l
  10  .Nd convert a wide-character string to a character string
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -52,6 +53,12 @@
  14  .Fa "char * restrict mbstring" "const wchar_t * restrict wcstring"
  15  .Fa "size_t nbytes"
  16  .Fc
  17 +.In xlocale.h
  18 +.Ft size_t
  19 +.Fo wcstombs_l
  20 +.Fa "char * restrict mbstring" "const wchar_t * restrict wcstring"
  21 +.Fa "size_t nbytes" "locale_t loc"
  22 +.Fc
  23  .Sh DESCRIPTION
  24  The
  25  .Fn wcstombs
  26 @@ -66,6 +73,14 @@
  27  .Fa mbstring .
  28  Partial multibyte characters at the end of the string are not stored.
  29  The multibyte character string is null terminated if there is room.
  30 +.Pp
  31 +While the
  32 +.Fn wcstombs
  33 +function uses the current locale, the
  34 +.Fn wcstombs_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 wcstombs
  41 @@ -86,7 +101,8 @@
  42  .Xr mbstowcs 3 ,
  43  .Xr multibyte 3 ,
  44  .Xr wcsrtombs 3 ,
  45 -.Xr wctomb 3
  46 +.Xr wctomb 3 ,
  47 +.Xr xlocale 3
  48  .Sh STANDARDS
  49  The
  50  .Fn wcstombs