locale/FreeBSD/wcsrtombs.3.patch

   1 --- wcsrtombs.3.orig    Fri Mar 11 18:15:27 2005
   2 +++ wcsrtombs.3 Fri Mar 11 18:18:11 2005
   3 @@ -29,7 +29,9 @@
   4  .Os
   5  .Sh NAME
   6  .Nm wcsrtombs ,
   7 -.Nm wcsnrtombs
   8 +.Nm wcsnrtombs ,
   9 +.Nm wcsrtombs_l ,
  10 +.Nm wcsnrtombs_l
  11  .Nd "convert a wide-character string to a character string (restartable)"
  12  .Sh LIBRARY
  13  .Lb libc
  14 @@ -45,6 +47,17 @@
  15  .Fa "char * restrict dst" "const wchar_t ** restrict src" "size_t nwc"
  16  .Fa "size_t len" "mbstate_t * restrict ps"
  17  .Fc
  18 +.In xlocale.h
  19 +.Ft size_t
  20 +.Fo wcsrtombs_l
  21 +.Fa "char * restrict dst" "const wchar_t ** restrict src"
  22 +.Fa "size_t len" "mbstate_t * restrict ps" "locale_t loc"
  23 +.Fc
  24 +.Ft size_t
  25 +.Fo wcsnrtombs_l
  26 +.Fa "char * restrict dst" "const wchar_t ** restrict src" "size_t nwc"
  27 +.Fa "size_t len" "mbstate_t * restrict ps" "locale_t loc"
  28 +.Fc
  29  .Sh DESCRIPTION
  30  The
  31  .Fn wcsrtombs
  32 @@ -97,6 +110,18 @@
  33  .Fa nwc
  34  characters from the buffer pointed to by
  35  .Fa src .
  36 +.Pp
  37 +While the
  38 +.Fn wcsrtombs
  39 +and
  40 +.Fn wcsnrtombs
  41 +functions use the current locale, the
  42 +.Fn wcsrtombs_l
  43 +and
  44 +.Fn wcsnrtombs_l
  45 +functions may be passed locales directly. See
  46 +.Xr xlocale 3
  47 +for more information.
  48  .Sh RETURN VALUES
  49  The
  50  .Fn wcsrtombs
  51 @@ -122,7 +147,8 @@
  52  .Sh SEE ALSO
  53  .Xr mbsrtowcs 3 ,
  54  .Xr wcrtomb 3 ,
  55 -.Xr wcstombs 3
  56 +.Xr wcstombs 3 ,
  57 +.Xr xlocale 3
  58  .Sh STANDARDS
  59  The
  60  .Fn wcsrtombs