Libc-1158.1.2.tar.gz

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

diff --git a/locale/FreeBSD/toupper.3 b/locale/FreeBSD/toupper.3
index cf23d1586d3bcc752ad85e907d1489c6ffb876ac..5b196a94d10f43528dd634442160b91dd2cba677 100644 (file)
--- a/locale/FreeBSD/toupper.3
+++ b/locale/FreeBSD/toupper.3
@@ -36,14 +36,24 @@
 .Dt TOUPPER 3
 .Os
 .Sh NAME
 .Dt TOUPPER 3
 .Os
 .Sh NAME

-.Nm toupper
+.Nm toupper ,
+.Nm toupper_l

 .Nd lower case to upper case letter conversion
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In ctype.h
 .Ft int
 .Nd lower case to upper case letter conversion
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In ctype.h
 .Ft int

-.Fn toupper "int c"
+.Fo toupper
+.Fa "int c"
+.Fc
+.In ctype.h
+.In xlocale.h
+.Ft int
+.Fo toupper_l
+.Fa "int c"
+.Fa "locale_t loc"
+.Fc

 .Sh DESCRIPTION
 The
 .Fn toupper
 .Sh DESCRIPTION
 The
 .Fn toupper


@@ -53,11 +63,19 @@ The argument must be representable as an
 .Vt "unsigned char"
 or the value of
 .Dv EOF .
 .Vt "unsigned char"
 or the value of
 .Dv EOF .

+.Pp
+Although the
+.Fn toupper
+function uses the current locale, the
+.Fn toupper_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 toupper
 function returns the corresponding upper-case letter if there is
 .Sh RETURN VALUES
 If the argument is a lower-case letter, the
 .Fn toupper
 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 COMPATIBILITY
 The
 .Bx 4.4
 .Sh COMPATIBILITY
 The
 .Bx 4.4


@@ -71,7 +89,8 @@ function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr isupper 3 ,
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr isupper 3 ,

-.Xr towupper 3
+.Xr towupper 3 ,
+.Xr xlocale 3

 .Sh STANDARDS
 The
 .Fn toupper
 .Sh STANDARDS
 The
 .Fn toupper