locale/FreeBSD/btowc.3.patch

   1 --- btowc.3.orig        2009-11-09 15:05:25.000000000 -0800
   2 +++ btowc.3     2009-11-09 15:05:25.000000000 -0800
   3 @@ -29,16 +29,35 @@
   4  .Os
   5  .Sh NAME
   6  .Nm btowc ,
   7 -.Nm wctob
   8 +.Nm btowc_l ,
   9 +.Nm wctob ,
  10 +.Nm wctob_l
  11  .Nd "convert between wide and single-byte characters"
  12  .Sh LIBRARY
  13  .Lb libc
  14  .Sh SYNOPSIS
  15 +.In stdio.h
  16  .In wchar.h
  17  .Ft wint_t
  18 -.Fn btowc "int c"
  19 +.Fo btowc
  20 +.Fa "int c"
  21 +.Fc
  22  .Ft int
  23 -.Fn wctob "wint_t c"
  24 +.Fo wctob
  25 +.Fa "wint_t c"
  26 +.Fc
  27 +.In wchar.h
  28 +.In xlocale.h
  29 +.Ft wint_t
  30 +.Fo btowc_l
  31 +.Fa "int c"
  32 +.Fa "locale_t loc"
  33 +.Fc
  34 +.Ft int
  35 +.Fo wctob_l
  36 +.Fa "wint_t c"
  37 +.Fa "locale_t loc"
  38 +.Fc
  39  .Sh DESCRIPTION
  40  The
  41  .Fn btowc
  42 @@ -59,10 +78,29 @@ or not able to be represented as a singl
  43  .Fn wctob
  44  returns
  45  .Dv WEOF .
  46 +.Pp
  47 +While the
  48 +.Fn btowc
  49 +and
  50 +.Fn wctob
  51 +functions use the current locale, the
  52 +.Fn btowc_l
  53 +and
  54 +.Fn wctob_l
  55 +functions may be passed locales directly. See
  56 +.Xr xlocale 3
  57 +for more information.
  58 +.Sh LEGACY SYNOPSIS
  59 +.Pp
  60 +The include file
  61 +.In stdio.h
  62 +is not necessary for these functions.
  63  .Sh SEE ALSO
  64  .Xr mbrtowc 3 ,
  65  .Xr multibyte 3 ,
  66 -.Xr wcrtomb 3
  67 +.Xr wcrtomb 3 ,
  68 +.Xr xlocale 3 ,
  69 +.Xr compat 5
  70  .Sh STANDARDS
  71  The
  72  .Fn btowc