string/FreeBSD/wcsxfrm.3.patch

   1 --- wcsxfrm.3.orig      Fri Mar 11 08:31:43 2005
   2 +++ wcsxfrm.3   Fri Mar 11 09:44:27 2005
   3 @@ -41,7 +41,8 @@
   4  .Dt WCSXFRM 3
   5  .Os
   6  .Sh NAME
   7 -.Nm wcsxfrm
   8 +.Nm wcsxfrm ,
   9 +.Nm wcsxfrm_l
  10  .Nd transform a wide string under locale
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -49,6 +50,9 @@
  14  .In wchar.h
  15  .Ft size_t
  16  .Fn wcsxfrm "wchar_t * restrict dst" "const wchar_t * restrict src" "size_t n"
  17 +.In xlocale.h
  18 +.Ft size_t
  19 +.Fn wcsxfrm_l "wchar_t * restrict dst" "const wchar_t * restrict src" "size_t n" "locale_t loc"
  20  .Sh DESCRIPTION
  21  The
  22  .Fn wcsxfrm
  23 @@ -80,6 +84,14 @@
  24  is equivalent to comparing
  25  two original strings with
  26  .Fn wcscoll .
  27 +.Pp
  28 +While the
  29 +.Fn wcsxfrm
  30 +function uses the current locale, the
  31 +.Fn wcsxfrm_l
  32 +function may be passed a locale directly. See
  33 +.Xr xlocale 3
  34 +for more information.
  35  .Sh RETURN VALUES
  36  Upon successful completion,
  37  .Fn wcsxfrm
  38 @@ -94,7 +106,8 @@
  39  .Xr setlocale 3 ,
  40  .Xr strxfrm 3 ,
  41  .Xr wcscmp 3 ,
  42 -.Xr wcscoll 3
  43 +.Xr wcscoll 3 ,
  44 +.Xr xlocale 3
  45  .Sh STANDARDS
  46  The
  47  .Fn wcsxfrm