locale/FreeBSD/toupper.3.patch

   1 --- _SB/Libc/locale/FreeBSD/toupper.3   2004-11-25 11:38:20.000000000 -0800
   2 +++ _SB/Libc/locale/FreeBSD/toupper.3.edit      2006-06-28 16:55:51.000000000 -0700
   3 @@ -40,14 +40,24 @@
   4  .Dt TOUPPER 3
   5  .Os
   6  .Sh NAME
   7 -.Nm toupper
   8 +.Nm toupper ,
   9 +.Nm toupper_l
  10  .Nd lower case to upper case letter conversion
  11  .Sh LIBRARY
  12  .Lb libc
  13  .Sh SYNOPSIS
  14  .In ctype.h
  15  .Ft int
  16 -.Fn toupper "int c"
  17 +.Fo toupper
  18 +.Fa "int c"
  19 +.Fc
  20 +.In ctype.h
  21 +.In xlocale.h
  22 +.Ft int
  23 +.Fo toupper_l
  24 +.Fa "int c"
  25 +.Fa "locale_t loc"
  26 +.Fc
  27  .Sh DESCRIPTION
  28  The
  29  .Fn toupper
  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 toupper
  44 +function uses the current locale, the
  45 +.Fn toupper_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 a lower-case letter, the
  51  .Fn toupper
  52  function returns the corresponding upper-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 isupper 3 ,
  61  .Xr multibyte 3 ,
  62 -.Xr towupper 3
  63 +.Xr towupper 3 ,
  64 +.Xr xlocale 3
  65  .Sh STANDARDS
  66  The
  67  .Fn toupper