Libc-1439.40.11.tar.gz

[apple/libc.git] / string / FreeBSD / strcoll.3

diff --git a/string/FreeBSD/strcoll.3 b/string/FreeBSD/strcoll.3
index 8c18f77eba571fab687f6c5e8db632ee16046550..fcbbbe1d663213f82767281a512a41bc9d8171a7 100644 (file)
--- a/string/FreeBSD/strcoll.3
+++ b/string/FreeBSD/strcoll.3
@@ -36,14 +36,26 @@
 .Dt STRCOLL 3
 .Os
 .Sh NAME
-.Nm strcoll
-.Nd compare strings according to current collation
+.Nm strcoll ,
+.Nm strcoll_l
+.Nd compare strings, according to current collation
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In string.h
 .Ft int
-.Fn strcoll "const char *s1" "const char *s2"
+.Fo strcoll
+.Fa "const char *s1"
+.Fa "const char *s2"
+.Fc
+.In string.h
+.In xlocale.h
+.Ft int
+.Fo strcoll_l
+.Fa "const char *s1"
+.Fa "const char *s2"
+.Fa "locale_t loc"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn strcoll
@@ -62,11 +74,20 @@ If information about the current locale collation is not available,
 the value of
 .Fn strcmp s1 s2
 is returned.
+.Pp
+Although 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