locale/FreeBSD/toupper.3.patch

   1 --- toupper.3.orig      Fri Mar 11 19:44:47 2005
   2 +++ toupper.3   Fri Mar 11 19:51:26 2005
   3 @@ -40,7 +40,8 @@
   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 @@ -48,6 +49,9 @@
  14  .In ctype.h
  15  .Ft int
  16  .Fn toupper "int c"
  17 +.In xlocale.h
  18 +.Ft int
  19 +.Fn toupper_l "int c" "locale_t loc"
  20  .Sh DESCRIPTION
  21  The
  22  .Fn toupper
  23 @@ -62,6 +66,14 @@
  24  .Li unsigned char
  25  or the value of
  26  .Dv EOF .
  27 +.Pp
  28 +While the
  29 +.Fn toupper
  30 +function uses the current locale, the
  31 +.Fn toupper_l
  32 +function may be passed a locale directly. See
  33 +.Xr xlocale 3
  34 +for more information.
  35  .Sh RETURN VALUES
  36  If the argument is a lower-case letter, the
  37  .Fn toupper
  38 @@ -81,7 +93,8 @@
  39  .Xr ctype 3 ,
  40  .Xr isupper 3 ,
  41  .Xr multibyte 3 ,
  42 -.Xr towupper 3
  43 +.Xr towupper 3 ,
  44 +.Xr xlocale 3
  45  .Sh STANDARDS
  46  The
  47  .Fn toupper