strcasecmp.3.patch   [plain text]


--- strcasecmp.3.orig	2009-11-30 13:52:22.000000000 -0800
+++ strcasecmp.3	2009-11-30 15:12:56.000000000 -0800
@@ -35,16 +35,40 @@
 .Os
 .Sh NAME
 .Nm strcasecmp ,
-.Nm strncasecmp
+.Nm strcasecmp_l ,
+.Nm strncasecmp ,
+.Nm strncasecmp_l
 .Nd compare strings, ignoring case
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In strings.h
 .Ft int
-.Fn strcasecmp "const char *s1" "const char *s2"
+.Fo strcasecmp
+.Fa "const char *s1"
+.Fa "const char *s2"
+.Fc
 .Ft int
-.Fn strncasecmp "const char *s1" "const char *s2" "size_t len"
+.Fo strncasecmp
+.Fa "const char *s1"
+.Fa "const char *s2"
+.Fa "size_t n"
+.Fc
+.In strings.h
+.In xlocale.h
+.Ft int
+.Fo strcasecmp_l
+.Fa "const char *s1"
+.Fa "const char *s2"
+.Fa "locale_t loc"
+.Fc
+.Ft int
+.Fo strncasecmp_l
+.Fa "const char *s1"
+.Fa "const char *s2"
+.Fa "size_t n"
+.Fa "locale_t loc"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn strcasecmp
@@ -59,8 +83,20 @@ and
 The
 .Fn strncasecmp
 compares at most
-.Fa len
+.Fa n
 characters.
+.Pp
+Although the
+.Fn strcasecmp
+and
+.Fn strncasecmp
+functions use the current locale, the
+.Fn strcasecmp_l
+and
+.Fn strncasecmp_l
+functions may be passed locales directly. See
+.Xr xlocale 3
+for more information.
 .Sh RETURN VALUES
 The
 .Fn strcasecmp
@@ -84,7 +120,7 @@ is greater than
 .Xr strcoll 3 ,
 .Xr strxfrm 3 ,
 .Xr tolower 3 ,
-.Xr wcscasecmp 3
+.Xr xlocale 3
 .Sh HISTORY
 The
 .Fn strcasecmp