des_crypt.3: Minor wording fix in VERSIONS

[thirdparty/man-pages.git] / man3 / wcsncasecmp.3

diff --git a/man3/wcsncasecmp.3 b/man3/wcsncasecmp.3
index cadb86b325f9db17c7e5c1c0c81d75014a95f922..def52ef48ef91085ec35bca5adb1bdf3a2c9e78c 100644 (file)
--- a/man3/wcsncasecmp.3
+++ b/man3/wcsncasecmp.3
@@ -1,24 +1,45 @@
 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
 .\" the License, or (at your option) any later version.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"   GNU glibc-2 source code and manual
 .\"   Dinkumware C library reference http://www.dinkumware.com/
-.\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
+.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
 .\"
-.TH WCSNCASECMP 3  1999-07-25 "GNU" "Linux Programmer's Manual"
+.TH WCSNCASECMP 3 2016-03-15 "GNU" "Linux Programmer's Manual"
 .SH NAME
 wcsncasecmp \- compare two fixed-size wide-character strings, ignoring case
 .SH SYNOPSIS
 .nf
 .B #include <wchar.h>
-.sp
+.PP
 .BI "int wcsncasecmp(const wchar_t *" s1 ", const wchar_t *" s2 ", size_t " n );
 .fi
+.PP
+.in -4n
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.PP
+.BR wcsncasecmp ():
+.PD 0
+.ad l
+.RS 4
+.TP 4
+Since glibc 2.10:
+_POSIX_C_SOURCE\ >=\ 200809L
+.TP
+Before glibc 2.10:
+_GNU_SOURCE
+.RE
+.ad
+.PD
 .SH DESCRIPTION
 The
 .BR wcsncasecmp ()
@@ -26,25 +47,60 @@ function is the wide-character equivalent of the
 .BR strncasecmp (3)
 function.
 It compares the wide-character string pointed to
-by \fIs1\fP and the wide-character string
-pointed to by \fIs2\fP, but at most
-\fIn\fP wide characters from each string, ignoring case differences
+by
+.I s1
+and the wide-character string
+pointed to by
+.IR s2 ,
+but at most
+.I n
+wide characters from each string, ignoring case differences
 .RB ( towupper (3),
 .BR towlower (3)).
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR wcsncasecmp ()
 function returns zero
 if the wide-character strings at
-\fIs1\fP and \fIs2\fP,
-truncated to at most length \fIn\fP, are equal except
+.I s1
+and
+.IR s2 ,
+truncated to at most length
+.IR n ,
+are equal except
 for case distinctions.
-It returns a positive integer if truncated \fIs1\fP is
-greater than truncated \fIs2\fP, ignoring case.
+It returns a positive integer if truncated
+.I s1
+is
+greater than truncated
+.IR s2 ,
+ignoring case.
 It returns a negative integer
-if truncated \fIs1\fP is smaller than truncated \fIs2\fP, ignoring case.
-.SH "CONFORMING TO"
-This function is a GNU extension.
+if truncated
+.I s1
+is smaller than truncated
+.IR s2 ,
+ignoring case.
+.SH VERSIONS
+The
+.BR wcsncasecmp ()
+function is provided in glibc since version 2.1.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR wcsncasecmp ()
+T}     Thread safety   MT-Safe locale
+.TE
+.SH CONFORMING TO
+POSIX.1-2008.
+This function is not specified in POSIX.1-2001,
+and is not widely available on other systems.
 .SH NOTES
 The behavior of
 .BR wcsncasecmp ()
@@ -52,6 +108,6 @@ depends on the
 .B LC_CTYPE
 category of the
 current locale.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR strncasecmp (3),
 .BR wcsncmp (3)