--- _SB/Libc/locale/FreeBSD/towupper.3 2003-05-20 15:21:44.000000000 -0700 +++ _SB/Libc/locale/FreeBSD/towupper.3.edit 2006-06-28 16:55:51.000000000 -0700 @@ -40,29 +40,48 @@ .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 -.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. +.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 -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 , -.Xr wctrans 3 +.Xr wctrans 3 , +.Xr xlocale 3 .Sh STANDARDS The .Fn towupper