LDP: Update original to LDP v3.68

[linuxjm/LDP_man-pages.git] / original / man3 / strcasecmp.3

diff --git a/original/man3/strcasecmp.3 b/original/man3/strcasecmp.3
index 43d0ecb..2ef5715 100644 (file)
--- a/original/man3/strcasecmp.3
+++ b/original/man3/strcasecmp.3
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,13 +20,14 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
 .\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
 .\"     386BSD man pages
 .\" Modified Sat Jul 24 18:12:45 1993 by Rik Faith (faith@cs.unc.edu)
-.TH STRCASECMP 3  1993-04-11 "" "Linux Programmer's Manual"
+.TH STRCASECMP 3  2014-05-10 "" "Linux Programmer's Manual"
 .SH NAME
 strcasecmp, strncasecmp \- compare two strings ignoring case
 .SH SYNOPSIS
@@ -39,32 +41,69 @@ strcasecmp, strncasecmp \- compare two strings ignoring case
 .SH DESCRIPTION
 The
 .BR strcasecmp ()
-function compares the two strings \fIs1\fP and
-\fIs2\fP, ignoring the case of the characters.
+function compares the two strings
+.I s1
+and
+.IR s2 ,
+ignoring the case of the characters.
 It returns an integer
-less than, equal to, or greater than zero if \fIs1\fP is found,
-respectively, to be less than, to match, or be greater than \fIs2\fP.
+less than, equal to, or greater than zero if
+.I s1
+is found,
+respectively, to be less than, to match, or be greater than
+.IR s2 .
 .PP
 The
 .BR strncasecmp ()
-function is similar, except it only compares
-the first \fIn\fP characters of \fIs1\fP.
-.SH "RETURN VALUE"
+function is similar, except it compares
+the only first
+.I n
+bytes of
+.IR s1 .
+.SH RETURN VALUE
 The
 .BR strcasecmp ()
 and
 .BR strncasecmp ()
 functions return
-an integer less than, equal to, or greater than zero if \fIs1\fP
-(or the first \fIn\fP bytes thereof) is found, respectively, to be
-less than, to match, or be greater than \fIs2\fP.
-.SH "CONFORMING TO"
+an integer less than, equal to, or greater than zero if
+.I s1
+(or the first
+.I n
+bytes thereof) is found, respectively, to be
+less than, to match, or be greater than
+.IR s2 .
+.SH CONFORMING TO
 4.4BSD, POSIX.1-2001.
-.SH "SEE ALSO"
+.SH NOTES
+The
+.BR strcasecmp ()
+and
+.BR strncasecmp ()
+functions first appeared in 4.4BSD, where they were declared in
+.IR <string.h> .
+Thus, for reasons of historical compatibility, the glibc
+.I <string.h>
+header file also declares these functions, if the
+.B _DEFAULT_SOURCE
+(or, in glibc 2.19 and earlier,
+.BR _BSD_SOURCE )
+feature test macro is defined.
+.SH SEE ALSO
 .BR bcmp (3),
 .BR memcmp (3),
 .BR strcmp (3),
 .BR strcoll (3),
+.BR string (3),
 .BR strncmp (3),
 .BR wcscasecmp (3),
 .BR wcsncasecmp (3)
+.SH COLOPHON
+This page is part of release 3.68 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.