Libc-1082.20.4.tar.gz

[apple/libc.git] / locale / FreeBSD / towupper.3

diff --git a/locale/FreeBSD/towupper.3 b/locale/FreeBSD/towupper.3
index 1d3763b632d91a5e488c943ac440bc5760d9d6ed..5df8bb0551b2669f0c49b970b35f5333d06dbb11 100644 (file)
--- a/locale/FreeBSD/towupper.3
+++ b/locale/FreeBSD/towupper.3
@@ -36,29 +36,48 @@
 .Dt TOWUPPER 3
 .Os
 .Sh NAME
 .Dt TOWUPPER 3
 .Os
 .Sh NAME

-.Nm towupper
+.Nm towupper ,
+.Nm towupper_l

 .Nd "lower case to upper case letter conversion (wide character version)"
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In wctype.h
 .Ft wint_t
 .Nd "lower case to upper case letter conversion (wide character version)"
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In wctype.h
 .Ft wint_t

-.Fn towupper "wint_t wc"
+.Fo towupper
+.Fa "wint_t wc"
+.Fc
+.In wctype.h
+.In xlocale.h
+.Ft wint_t
+.Fo towupper_l
+.Fa "wint_t wc"
+.Fa "locale_t loc"
+.Fc

 .Sh DESCRIPTION
 The
 .Fn towupper
 function converts a lower-case letter to the corresponding
 upper-case letter.
 .Sh DESCRIPTION
 The
 .Fn towupper
 function converts a lower-case letter to the corresponding
 upper-case letter.

+.Pp
+Although the
+.Fn towupper
+function uses the current locale, the
+.Fn towupper_l
+function may be passed a locale directly. See
+.Xr xlocale 3
+for more information.

 .Sh RETURN VALUES
 If the argument is a lower-case letter, the
 .Fn towupper
 function returns the corresponding upper-case letter if there is
 .Sh RETURN VALUES
 If the argument is a lower-case letter, the
 .Fn towupper
 function returns the corresponding upper-case letter if there is

-one; otherwise the argument is returned unchanged.
+one; otherwise, the argument is returned unchanged.

 .Sh SEE ALSO
 .Xr iswupper 3 ,
 .Xr toupper 3 ,
 .Xr towlower 3 ,
 .Sh SEE ALSO
 .Xr iswupper 3 ,
 .Xr toupper 3 ,
 .Xr towlower 3 ,

-.Xr wctrans 3
+.Xr wctrans 3 ,
+.Xr xlocale 3

 .Sh STANDARDS
 The
 .Fn towupper
 .Sh STANDARDS
 The
 .Fn towupper