Libc-763.13.tar.gz

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

--- wctrans.3.orig	2009-11-09 15:05:25.000000000 -0800
+++ wctrans.3	2009-11-09 15:05:26.000000000 -0800
@@ -28,21 +28,42 @@
 .Dt WCTRANS 3
 .Os
 .Sh NAME
-.Nm towctrans , wctrans
+.Nm towctrans ,
+.Nm towctrans_l ,
+.Nm wctrans ,
+.Nm wctrans_l
 .Nd "wide character mapping functions"
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In wctype.h
 .Ft wint_t
-.Fn towctrans "wint_t wc" "wctrans_t desc"
+.Fo towctrans
+.Fa "wint_t wc"
+.Fa "wctrans_t desc"
+.Fc
 .Ft wctrans_t
-.Fn wctrans "const char *charclass"
+.Fo wctrans
+.Fa "const char *charclass"
+.Fc
+.In wctype.h
+.In xlocale.h
+.Ft wint_t
+.Fo towctrans_l
+.Fa "wint_t wc"
+.Fa "wctrans_t desc"
+.Fa "locale_t loc"
+.Fc
+.Ft wctrans_t
+.Fo wctrans_l
+.Fa "const char *charclass"
+.Fa "locale_t loc"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn wctrans
 function returns a value of type
-.Vt wctrans_t
+.Vt wctrans_t ,
 which represents the requested wide character mapping operation and
 may be used as the second argument for calls to
 .Fn towctrans .
@@ -55,9 +76,21 @@ The following character mapping names ar
 The
 .Fn towctrans
 function transliterates the wide character
-.Fa wc
+.Fa wc ,
 according to the mapping described by
 .Fa desc .
+.Pp
+While the
+.Fn towctrans
+and
+.Fn wctrans
+functions use the current locale, the
+.Fn towctrans_l
+and
+.Fn wctrans_l
+functions may be passed locales directly. See
+.Xr xlocale 3
+for more information.
 .Sh RETURN VALUES
 The
 .Fn towctrans
@@ -105,7 +138,8 @@ The requested mapping name is invalid.
 .Sh SEE ALSO
 .Xr tolower 3 ,
 .Xr toupper 3 ,
-.Xr wctype 3
+.Xr wctype 3 ,
+.Xr xlocale 3
 .Sh STANDARDS
 The
 .Fn towctrans