strcoll.3.patch   [plain text]


--- strcoll.3.orig	Fri Mar 11 08:36:09 2005
+++ strcoll.3	Fri Mar 11 09:43:41 2005
@@ -40,7 +40,8 @@
 .Dt STRCOLL 3
 .Os
 .Sh NAME
-.Nm strcoll
+.Nm strcoll ,
+.Nm strcoll_l
 .Nd compare strings according to current collation
 .Sh LIBRARY
 .Lb libc
@@ -48,6 +49,9 @@
 .In string.h
 .Ft int
 .Fn strcoll "const char *s1" "const char *s2"
+.In xlocale.h
+.Ft int
+.Fn strcoll_l "const char *s1" "const char *s2" "locale_t loc"
 .Sh DESCRIPTION
 The
 .Fn strcoll
@@ -63,11 +67,20 @@
 .Fa s1
 is greater than, equal to, or less than
 .Fa s2 .
+.Pp
+While the
+.Fn strcoll
+function uses the current locale, the
+.Fn strcoll_l
+function may be passed a locale directly. See
+.Xr xlocale 3
+for more information.
 .Sh SEE ALSO
 .Xr setlocale 3 ,
 .Xr strcmp 3 ,
 .Xr strxfrm 3 ,
-.Xr wcscoll 3
+.Xr wcscoll 3 ,
+.Xr xlocale 3
 .Sh STANDARDS
 The
 .Fn strcoll