locale/FreeBSD/tolower.3.patch

   1 --- _SB/Libc/locale/FreeBSD/tolower.3   2004-11-25 11:38:19.000000000 -0800
   2 +++ _SB/Libc/locale/FreeBSD/tolower.3.edit      2006-06-28 16:55:51.000000000 -0700
   3 @@ -40,14 +40,24 @@
   4  .Dt TOLOWER 3
   5  .Os
   6  .Sh NAME
   7 -.Nm tolower
   8 +.Nm tolower ,
   9 +.Nm tolower_l
  10  .Nd upper case to lower case letter conversion
  11  .Sh LIBRARY
  12  .Lb libc
  13  .Sh SYNOPSIS
  14  .In ctype.h
  15  .Ft int
  16 -.Fn tolower "int c"
  17 +.Fo tolower
  18 +.Fa "int c"
  19 +.Fc
  20 +.In ctype.h
  21 +.In xlocale.h
  22 +.Ft int
  23 +.Fo tolower_l
  24 +.Fa "int c"
  25 +.Fa "locale_t loc"
  26 +.Fc
  27  .Sh DESCRIPTION
  28  The
  29  .Fn tolower
  30 @@ -56,17 +66,25 @@
  31  For single C
  32  .Va char Ns s
  33  locales (see
  34 -.Xr multibyte 3 )
  35 +.Xr multibyte 3 ) ,
  36  the value of the argument is
  37  representable as an
  38  .Li unsigned char
  39  or the value of
  40  .Dv EOF .
  41 +.Pp
  42 +Although the
  43 +.Fn tolower
  44 +function uses the current locale, the
  45 +.Fn tolower_l
  46 +function may be passed a locale directly. See
  47 +.Xr xlocale 3
  48 +for more information.
  49  .Sh RETURN VALUES
  50  If the argument is an upper-case letter, the
  51  .Fn tolower
  52  function returns the corresponding lower-case letter if there is
  53 -one; otherwise the argument is returned unchanged.
  54 +one; otherwise, the argument is returned unchanged.
  55  .Sh COMPATIBILITY
  56  The
  57  .Bx 4.4
  58 @@ -81,7 +99,8 @@
  59  .Xr ctype 3 ,
  60  .Xr islower 3 ,
  61  .Xr multibyte 3 ,
  62 -.Xr towlower 3
  63 +.Xr towlower 3 ,
  64 +.Xr xlocale 3
  65  .Sh STANDARDS
  66  The
  67  .Fn tolower