--- tolower.3.bsdnew 2009-11-10 13:13:11.000000000 -0800 +++ tolower.3 2009-11-10 13:51:11.000000000 -0800 @@ -36,14 +36,24 @@ .Dt TOLOWER 3 .Os .Sh NAME -.Nm tolower +.Nm tolower , +.Nm tolower_l .Nd upper case to lower case letter conversion .Sh LIBRARY .Lb libc .Sh SYNOPSIS .In ctype.h .Ft int -.Fn tolower "int c" +.Fo tolower +.Fa "int c" +.Fc +.In ctype.h +.In xlocale.h +.Ft int +.Fo tolower_l +.Fa "int c" +.Fa "locale_t loc" +.Fc .Sh DESCRIPTION The .Fn tolower @@ -53,11 +63,19 @@ The argument must be representable as an .Vt "unsigned char" or the value of .Dv EOF . +.Pp +Although the +.Fn tolower +function uses the current locale, the +.Fn tolower_l +function may be passed a locale directly. See +.Xr xlocale 3 +for more information. .Sh RETURN VALUES If the argument is an upper-case letter, the .Fn tolower function returns the corresponding lower-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 islower 3 , -.Xr towlower 3 +.Xr towlower 3 , +.Xr xlocale 3 .Sh STANDARDS The .Fn tolower