signal.7: Note async-signal-safe functions added by POSIX.1-2008 TC1

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

diff --git a/man3/wcsncpy.3 b/man3/wcsncpy.3
index 7ff29ae6edbc7e7beb50944b293551329a349d5c..e9ff8f39ef850dd64b66383c5d5335b05bf45692 100644 (file)
--- a/man3/wcsncpy.3
+++ b/man3/wcsncpy.3
@@ -1,9 +1,11 @@
 .\" 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
@@ -11,7 +13,7 @@
 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
 .\"   ISO/IEC 9899:1999
 .\"
-.TH WCSNCPY 3  2011-09-28 "GNU" "Linux Programmer's Manual"
+.TH WCSNCPY 3  2015-08-08 "GNU" "Linux Programmer's Manual"
 .SH NAME
 wcsncpy \- copy a fixed-size string of wide characters
 .SH SYNOPSIS
@@ -26,28 +28,57 @@ The
 function is the wide-character equivalent of the
 .BR strncpy (3)
 function.
-It copies at most \fIn\fP wide characters from the wide-character
-string pointed to by \fIsrc\fP,
+It copies at most
+.I n
+wide characters from the wide-character
+string pointed to by
+.IR src ,
 including the terminating null wide character (L\(aq\\0\(aq),
-to the array pointed to by \fIdest\fP.
-Exactly \fIn\fP wide characters are
-written at \fIdest\fP.
-If the length \fIwcslen(src)\fP is smaller than \fIn\fP,
+to the array pointed to by
+.IR dest .
+Exactly
+.I n
+wide characters are
+written at
+.IR dest .
+If the length \fIwcslen(src)\fP is smaller than
+.IR n ,
 the remaining wide characters in the array
-pointed to by \fIdest\fP are filled
+pointed to by
+.I dest
+are filled
 with null wide characters.
-If the length \fIwcslen(src)\fP is greater or equal
-to \fIn\fP, the string pointed to by \fIdest\fP
+If the length \fIwcslen(src)\fP is greater than or equal
+to
+.IR n ,
+the string pointed to by
+.I dest
 will not be terminated by a null wide character.
 .PP
 The strings may not overlap.
 .PP
-The programmer must ensure that there is room for at least \fIn\fP wide
-characters at \fIdest\fP.
-.SH "RETURN VALUE"
+The programmer must ensure that there is room for at least
+.I n
+wide
+characters at
+.IR dest .
+.SH RETURN VALUE
 .BR wcsncpy ()
-returns \fIdest\fP.
-.SH "CONFORMING TO"
-C99.
-.SH "SEE ALSO"
+returns
+.IR dest .
+.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 wcsncpy ()
+T}     Thread safety   MT-Safe
+.TE
+.SH CONFORMING TO
+POSIX.1-2001, POSIX.1-2008, C99.
+.SH SEE ALSO
 .BR strncpy (3)