Libc-498.tar.gz

[apple/libc.git] / locale / FreeBSD / wcsrtombs.3.patch

diff --git a/locale/FreeBSD/wcsrtombs.3.patch b/locale/FreeBSD/wcsrtombs.3.patch
index 18199dfc89b38249bd5eb805e09eb7c1dfc6206e..09fbb4b097492139046f1935aece9d347e1c993a 100644 (file)
--- a/locale/FreeBSD/wcsrtombs.3.patch
+++ b/locale/FreeBSD/wcsrtombs.3.patch
@@ -1,40 +1,79 @@
---- wcsrtombs.3.orig   Fri Mar 11 18:15:27 2005
-+++ wcsrtombs.3        Fri Mar 11 18:18:11 2005
-@@ -29,7 +29,9 @@
+--- _SB/Libc/locale/FreeBSD/wcsrtombs.3        2004-11-25 11:38:20.000000000 -0800
++++ _SB/Libc/locale/FreeBSD/wcsrtombs.3.edit   2006-06-28 16:55:51.000000000 -0700
+@@ -28,30 +28,57 @@
+ .Dt WCSRTOMBS 3
  .Os
  .Sh NAME
++.Nm wcsnrtombs ,
++.Nm wcsnrtombs_l ,
  .Nm wcsrtombs ,
 -.Nm wcsnrtombs
-+.Nm wcsnrtombs ,
-+.Nm wcsrtombs_l ,
-+.Nm wcsnrtombs_l
++.Nm wcsrtombs_l
  .Nd "convert a wide-character string to a character string (restartable)"
  .Sh LIBRARY
  .Lb libc
-@@ -45,6 +47,17 @@
- .Fa "char * restrict dst" "const wchar_t ** restrict src" "size_t nwc"
- .Fa "size_t len" "mbstate_t * restrict ps"
- .Fc
-+.In xlocale.h
-+.Ft size_t
-+.Fo wcsrtombs_l
-+.Fa "char * restrict dst" "const wchar_t ** restrict src"
-+.Fa "size_t len" "mbstate_t * restrict ps" "locale_t loc"
+ .Sh SYNOPSIS
+ .In wchar.h
+ .Ft size_t
++.Fo wcsnrtombs
++.Fa "char *restrict dst"
++.Fa "const wchar_t **restrict src"
++.Fa "size_t nwc"
++.Fa "size_t len"
++.Fa "mbstate_t *restrict ps"
 +.Fc
 +.Ft size_t
+ .Fo wcsrtombs
+-.Fa "char * restrict dst" "const wchar_t ** restrict src"
+-.Fa "size_t len" "mbstate_t * restrict ps"
++.Fa "char *restrict dst"
++.Fa "const wchar_t **restrict src"
++.Fa "size_t len"
++.Fa "mbstate_t *restrict ps"
+ .Fc
++.In wchar.h
++.In xlocale.h
+ .Ft size_t
+-.Fo wcsnrtombs
+-.Fa "char * restrict dst" "const wchar_t ** restrict src" "size_t nwc"
+-.Fa "size_t len" "mbstate_t * restrict ps"
 +.Fo wcsnrtombs_l
-+.Fa "char * restrict dst" "const wchar_t ** restrict src" "size_t nwc"
-+.Fa "size_t len" "mbstate_t * restrict ps" "locale_t loc"
++.Fa "char *restrict dst"
++.Fa "const wchar_t **restrict src"
++.Fa "size_t nwc"
++.Fa "size_t len"
++.Fa "mbstate_t *restrict ps"
++.Fa "locale_t loc"
 +.Fc
++.Ft size_t
++.Fo wcsrtombs_l
++.Fa "char *restrict dst"
++.Fa "const wchar_t **restrict src"
++.Fa "size_t len"
++.Fa "mbstate_t *restrict ps"
++.Fa "locale_t loc"
+ .Fc
  .Sh DESCRIPTION
  The
  .Fn wcsrtombs
-@@ -97,6 +110,18 @@
+-function converts a string of wide characters indirectly pointed to by
+-.Fa src
+-to a corresponding multibyte character string stored in the array
+-pointed to by
++function converts a string of wide characters,
++indirectly pointed to by
++.Fa src ,
++to a corresponding multi-byte character string,
++stored in the array pointed to by
+ .Fa dst .
+ No more than
+ .Fa len
+@@ -97,15 +124,28 @@
  .Fa nwc
  characters from the buffer pointed to by
  .Fa src .
 +.Pp
-+While the
++Although the
 +.Fn wcsrtombs
 +and
 +.Fn wcsnrtombs
@@ -46,9 +85,21 @@
 +.Xr xlocale 3
 +for more information.
  .Sh RETURN VALUES
- The
+-The
++If successful, the
  .Fn wcsrtombs
-@@ -122,7 +147,8 @@
+ and
+ .Fn wcsnrtombs
+ functions return the number of bytes stored in
+ the array pointed to by
+ .Fa dst
+-(not including any terminating null), if successful, otherwise it returns
++(not including any terminating null);
++otherwise, they return
+ .Po Vt size_t Pc Ns \-1 .
+ .Sh ERRORS
+ The
+@@ -122,7 +162,8 @@
  .Sh SEE ALSO
  .Xr mbsrtowcs 3 ,
  .Xr wcrtomb 3 ,