locale/FreeBSD/mbsrtowcs.3.patch

   1 --- mbsrtowcs.3.orig    Fri Mar 11 18:09:42 2005
   2 +++ mbsrtowcs.3 Fri Mar 11 18:11:17 2005
   3 @@ -28,7 +28,9 @@
   4  .Os
   5  .Sh NAME
   6  .Nm mbsrtowcs ,
   7 -.Nm mbsnrtowcs
   8 +.Nm mbsnrtowcs ,
   9 +.Nm mbsrtowcs_l ,
  10 +.Nm mbsnrtowcs_l
  11  .Nd "convert a character string to a wide-character string (restartable)"
  12  .Sh LIBRARY
  13  .Lb libc
  14 @@ -44,6 +46,17 @@
  15  .Fa "wchar_t * restrict dst" "const char ** restrict src" "size_t nms"
  16  .Fa "size_t len" "mbstate_t * restrict ps"
  17  .Fc
  18 +.In xlocale.h
  19 +.Ft size_t
  20 +.Fo mbsrtowcs_l
  21 +.Fa "wchar_t * restrict dst" "const char ** restrict src" "size_t len"
  22 +.Fa "mbstate_t * restrict ps" "locale_t loc"
  23 +.Fc
  24 +.Ft size_t
  25 +.Fo mbsnrtowcs_l
  26 +.Fa "wchar_t * restrict dst" "const char ** restrict src" "size_t nms"
  27 +.Fa "size_t len" "mbstate_t * restrict ps" "locale_t loc"
  28 +.Fc
  29  .Sh DESCRIPTION
  30  The
  31  .Fn mbsrtowcs
  32 @@ -97,6 +110,18 @@
  33  .Fa nms
  34  bytes from the buffer pointed to by
  35  .Fa src .
  36 +.Pp
  37 +While the
  38 +.Fn mbsrtowcs
  39 +and
  40 +.Fn mbsnrtowcs
  41 +functions use the current locale, the
  42 +.Fn mbsrtowcs_l
  43 +and
  44 +.Fn mbsnrtowcs_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 mbsrtowcs
  51 @@ -123,7 +148,8 @@
  52  .Xr mbrtowc 3 ,
  53  .Xr mbstowcs 3 ,
  54  .Xr multibyte 3 ,
  55 -.Xr wcsrtombs 3
  56 +.Xr wcsrtombs 3 ,
  57 +.Xr xlocale 3
  58  .Sh STANDARDS
  59  The
  60  .Fn mbsrtowcs