locale/FreeBSD/wctrans.3.patch

   1 --- wctrans.3.orig      2009-11-09 15:05:25.000000000 -0800
   2 +++ wctrans.3   2009-11-09 15:05:26.000000000 -0800
   3 @@ -28,21 +28,42 @@
   4  .Dt WCTRANS 3
   5  .Os
   6  .Sh NAME
   7 -.Nm towctrans , wctrans
   8 +.Nm towctrans ,
   9 +.Nm towctrans_l ,
  10 +.Nm wctrans ,
  11 +.Nm wctrans_l
  12  .Nd "wide character mapping functions"
  13  .Sh LIBRARY
  14  .Lb libc
  15  .Sh SYNOPSIS
  16  .In wctype.h
  17  .Ft wint_t
  18 -.Fn towctrans "wint_t wc" "wctrans_t desc"
  19 +.Fo towctrans
  20 +.Fa "wint_t wc"
  21 +.Fa "wctrans_t desc"
  22 +.Fc
  23  .Ft wctrans_t
  24 -.Fn wctrans "const char *charclass"
  25 +.Fo wctrans
  26 +.Fa "const char *charclass"
  27 +.Fc
  28 +.In wctype.h
  29 +.In xlocale.h
  30 +.Ft wint_t
  31 +.Fo towctrans_l
  32 +.Fa "wint_t wc"
  33 +.Fa "wctrans_t desc"
  34 +.Fa "locale_t loc"
  35 +.Fc
  36 +.Ft wctrans_t
  37 +.Fo wctrans_l
  38 +.Fa "const char *charclass"
  39 +.Fa "locale_t loc"
  40 +.Fc
  41  .Sh DESCRIPTION
  42  The
  43  .Fn wctrans
  44  function returns a value of type
  45 -.Vt wctrans_t
  46 +.Vt wctrans_t ,
  47  which represents the requested wide character mapping operation and
  48  may be used as the second argument for calls to
  49  .Fn towctrans .
  50 @@ -55,9 +76,21 @@ The following character mapping names ar
  51  The
  52  .Fn towctrans
  53  function transliterates the wide character
  54 -.Fa wc
  55 +.Fa wc ,
  56  according to the mapping described by
  57  .Fa desc .
  58 +.Pp
  59 +While the
  60 +.Fn towctrans
  61 +and
  62 +.Fn wctrans
  63 +functions use the current locale, the
  64 +.Fn towctrans_l
  65 +and
  66 +.Fn wctrans_l
  67 +functions may be passed locales directly. See
  68 +.Xr xlocale 3
  69 +for more information.
  70  .Sh RETURN VALUES
  71  The
  72  .Fn towctrans
  73 @@ -105,7 +138,8 @@ The requested mapping name is invalid.
  74  .Sh SEE ALSO
  75  .Xr tolower 3 ,
  76  .Xr toupper 3 ,
  77 -.Xr wctype 3
  78 +.Xr wctype 3 ,
  79 +.Xr xlocale 3
  80  .Sh STANDARDS
  81  The
  82  .Fn towctrans