--- toupper.3.bsdnew 2009-11-10 13:13:11.000000000 -0800 +++ toupper.3 2009-11-10 13:52:49.000000000 -0800 @@ -36,14 +36,24 @@ .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 -.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 @@ -53,11 +63,19 @@ The argument must be representable as an .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 -one; otherwise the argument is returned unchanged. +one; otherwise, the argument is returned unchanged. .Sh COMPATIBILITY The .Bx 4.4 @@ -71,7 +89,8 @@ function should be used instead. .Sh SEE ALSO .Xr ctype 3 , .Xr isupper 3 , -.Xr towupper 3 +.Xr towupper 3 , +.Xr xlocale 3 .Sh STANDARDS The .Fn toupper