locale/FreeBSD/btowc.3.patch

   1 --- btowc.3.orig        Fri Mar 11 18:06:40 2005
   2 +++ btowc.3     Fri Mar 11 18:08:08 2005
   3 @@ -29,7 +29,9 @@
   4  .Os
   5  .Sh NAME
   6  .Nm btowc ,
   7 -.Nm wctob
   8 +.Nm wctob ,
   9 +.Nm btowc_l ,
  10 +.Nm wctob_l
  11  .Nd "convert between wide and single-byte characters"
  12  .Sh LIBRARY
  13  .Lb libc
  14 @@ -39,6 +41,11 @@
  15  .Fn btowc "int c"
  16  .Ft int
  17  .Fn wctob "wint_t c"
  18 +.In xlocale.h
  19 +.Ft wint_t
  20 +.Fn btowc_l "int c" "locale_t loc"
  21 +.Ft int
  22 +.Fn wctob_l "wint_t c" "locale_t loc"
  23  .Sh DESCRIPTION
  24  The
  25  .Fn btowc
  26 @@ -59,10 +66,23 @@
  27  .Fn wctob
  28  returns
  29  .Dv WEOF .
  30 +.Pp
  31 +While the
  32 +.Fn btowc
  33 +and
  34 +.Fn wctob
  35 +functions use the current locale, the
  36 +.Fn btowc_l
  37 +and
  38 +.Fn wctob_l
  39 +functions may be passed locales directly. See
  40 +.Xr xlocale 3
  41 +for more information.
  42  .Sh SEE ALSO
  43  .Xr mbrtowc 3 ,
  44  .Xr multibyte 3 ,
  45 -.Xr wcrtomb 3
  46 +.Xr wcrtomb 3 ,
  47 +.Xr xlocale 3
  48  .Sh STANDARDS
  49  The
  50  .Fn btowc