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 cd29b47c9c3533b765b9c924794baad7bd4b54df..def52ef48ef91085ec35bca5adb1bdf3a2c9e78c 100644 (file)
--- a/man3/wcsncasecmp.3
+++ b/man3/wcsncasecmp.3
@@ -1,47 +1,113 @@
 .\" 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 \fBwcsncasecmp\fP() function is the wide-character equivalent of the
-\fBstrncasecmp\fP() function.
+The
+.BR wcsncasecmp ()
+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
-(\fBtowupper\fP(), \fBtowlower\fP()).
-.SH "RETURN VALUE"
-The \fBwcsncasecmp\fP() function returns zero
+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
+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.
-.SH "SEE ALSO"
-.BR strncasecmp (3),
-.BR wcsncmp (3)
+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 behaviour of \fBwcsncasecmp\fP() depends on the LC_CTYPE category of the
+The behavior of
+.BR wcsncasecmp ()
+depends on the
+.B LC_CTYPE
+category of the
 current locale.
+.SH SEE ALSO
+.BR strncasecmp (3),
+.BR wcsncmp (3)