string/FreeBSD/strcoll.3.patch

   1 --- strcoll.3.orig      Fri Mar 11 08:36:09 2005
   2 +++ strcoll.3   Fri Mar 11 09:43:41 2005
   3 @@ -40,7 +40,8 @@
   4  .Dt STRCOLL 3
   5  .Os
   6  .Sh NAME
   7 -.Nm strcoll
   8 +.Nm strcoll ,
   9 +.Nm strcoll_l
  10  .Nd compare strings according to current collation
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -48,6 +49,9 @@
  14  .In string.h
  15  .Ft int
  16  .Fn strcoll "const char *s1" "const char *s2"
  17 +.In xlocale.h
  18 +.Ft int
  19 +.Fn strcoll_l "const char *s1" "const char *s2" "locale_t loc"
  20  .Sh DESCRIPTION
  21  The
  22  .Fn strcoll
  23 @@ -63,11 +67,20 @@
  24  .Fa s1
  25  is greater than, equal to, or less than
  26  .Fa s2 .
  27 +.Pp
  28 +While the
  29 +.Fn strcoll
  30 +function uses the current locale, the
  31 +.Fn strcoll_l
  32 +function may be passed a locale directly. See
  33 +.Xr xlocale 3
  34 +for more information.
  35  .Sh SEE ALSO
  36  .Xr setlocale 3 ,
  37  .Xr strcmp 3 ,
  38  .Xr strxfrm 3 ,
  39 -.Xr wcscoll 3
  40 +.Xr wcscoll 3 ,
  41 +.Xr xlocale 3
  42  .Sh STANDARDS
  43  The
  44  .Fn strcoll