--- _SB/Libc/locale/FreeBSD/tolower.3 2004-11-25 11:38:19.000000000 -0800 +++ _SB/Libc/locale/FreeBSD/tolower.3.edit 2006-06-28 16:55:51.000000000 -0700 @@ -40,14 +40,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 @@ -56,17 +66,25 @@ For single C .Va char Ns s locales (see -.Xr multibyte 3 ) +.Xr multibyte 3 ) , the value of the argument is representable as an .Li 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 @@ -81,7 +99,8 @@ .Xr ctype 3 , .Xr islower 3 , .Xr multibyte 3 , -.Xr towlower 3 +.Xr towlower 3 , +.Xr xlocale 3 .Sh STANDARDS The .Fn tolower