string/FreeBSD/strcoll.3.patch

   1 --- strcoll.3.bsdnew    2009-11-30 13:52:22.000000000 -0800
   2 +++ strcoll.3   2009-11-30 14:29:06.000000000 -0800
   3 @@ -36,14 +36,26 @@
   4  .Dt STRCOLL 3
   5  .Os
   6  .Sh NAME
   7 -.Nm strcoll
   8 -.Nd compare strings according to current collation
   9 +.Nm strcoll ,
  10 +.Nm strcoll_l
  11 +.Nd compare strings, according to current collation
  12  .Sh LIBRARY
  13  .Lb libc
  14  .Sh SYNOPSIS
  15  .In string.h
  16  .Ft int
  17 -.Fn strcoll "const char *s1" "const char *s2"
  18 +.Fo strcoll
  19 +.Fa "const char *s1"
  20 +.Fa "const char *s2"
  21 +.Fc
  22 +.In string.h
  23 +.In xlocale.h
  24 +.Ft int
  25 +.Fo strcoll_l
  26 +.Fa "const char *s1"
  27 +.Fa "const char *s2"
  28 +.Fa "locale_t loc"
  29 +.Fc
  30  .Sh DESCRIPTION
  31  The
  32  .Fn strcoll
  33 @@ -62,11 +74,20 @@ If information about the current locale
  34  the value of
  35  .Fn strcmp s1 s2
  36  is returned.
  37 +.Pp
  38 +Although the
  39 +.Fn strcoll
  40 +function uses the current locale, the
  41 +.Fn strcoll_l
  42 +function may be passed a locale directly. See
  43 +.Xr xlocale 3
  44 +for more information.
  45  .Sh SEE ALSO
  46  .Xr setlocale 3 ,
  47  .Xr strcmp 3 ,
  48  .Xr strxfrm 3 ,
  49 -.Xr wcscoll 3
  50 +.Xr wcscoll 3 ,
  51 +.Xr xlocale 3
  52  .Sh STANDARDS
  53  The
  54  .Fn strcoll