string/FreeBSD/wcswidth.3.patch

   1 --- wcswidth.3.orig     Fri Mar 11 08:30:37 2005
   2 +++ wcswidth.3  Fri Mar 11 08:31:35 2005
   3 @@ -28,7 +28,8 @@
   4  .Dt WCSWIDTH 3
   5  .Os
   6  .Sh NAME
   7 -.Nm wcswidth
   8 +.Nm wcswidth ,
   9 +.Nm wcswidth_l
  10  .Nd "number of column positions in wide-character string"
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -36,6 +37,9 @@
  14  .In wchar.h
  15  .Ft int
  16  .Fn wcswidth "const wchar_t *pwcs" "size_t n"
  17 +.In xlocale.h
  18 +.Ft int
  19 +.Fn wcswidth_l "const wchar_t *pwcs" "size_t n" "locale_t loc"
  20  .Sh DESCRIPTION
  21  The
  22  .Fn wcswidth
  23 @@ -44,6 +48,14 @@
  24  characters of
  25  .Fa pwcs ,
  26  or until a null wide character (L'\e0') is encountered.
  27 +.Pp
  28 +While the
  29 +.Fn wcswidth
  30 +function uses the current locale, the
  31 +.Fn wcswidth_l
  32 +function may be passed a locale directly. See
  33 +.Xr xlocale 3
  34 +for more information.
  35  .Sh RETURN VALUES
  36  The
  37  .Fn wcswidth
  38 @@ -54,7 +66,8 @@
  39  otherwise it returns the number of column positions occupied.
  40  .Sh SEE ALSO
  41  .Xr iswprint 3 ,
  42 -.Xr wcwidth 3
  43 +.Xr wcwidth 3 ,
  44 +.Xr xlocale 3
  45  .Sh STANDARDS
  46  The
  47  .Fn wcswidth