locale/FreeBSD/toupper.3.patch

   1 --- toupper.3.bsdnew    2009-11-10 13:13:11.000000000 -0800
   2 +++ toupper.3   2009-11-10 13:52:49.000000000 -0800
   3 @@ -36,14 +36,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 @@ -53,11 +63,19 @@ The argument must be representable as an
  31  .Vt "unsigned char"
  32  or the value of
  33  .Dv EOF .
  34 +.Pp
  35 +Although the
  36 +.Fn toupper
  37 +function uses the current locale, the
  38 +.Fn toupper_l
  39 +function may be passed a locale directly. See
  40 +.Xr xlocale 3
  41 +for more information.
  42  .Sh RETURN VALUES
  43  If the argument is a lower-case letter, the
  44  .Fn toupper
  45  function returns the corresponding upper-case letter if there is
  46 -one; otherwise the argument is returned unchanged.
  47 +one; otherwise, the argument is returned unchanged.
  48  .Sh COMPATIBILITY
  49  The
  50  .Bx 4.4
  51 @@ -71,7 +89,8 @@ function should be used instead.
  52  .Sh SEE ALSO
  53  .Xr ctype 3 ,
  54  .Xr isupper 3 ,
  55 -.Xr towupper 3
  56 +.Xr towupper 3 ,
  57 +.Xr xlocale 3
  58  .Sh STANDARDS
  59  The
  60  .Fn toupper