proc.5: Note kernel version for /proc/PID/smaps VmFlags "wf" flag

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

diff --git a/man3/getwchar.3 b/man3/getwchar.3
index 10ad90c30d01790c601b330c833cb08e926eee5e..6f33a61d997130a5c69a386294aea81498031827 100644 (file)
--- a/man3/getwchar.3
+++ b/man3/getwchar.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
@@ -12,13 +14,13 @@
 .\"      http://www.UNIX-systems.org/online.html
 .\"   ISO/IEC 9899:1999
 .\"
-.TH GETWCHAR 3  1999-07-25 "GNU" "Linux Programmer's Manual"
+.TH GETWCHAR 3  2017-09-15 "GNU" "Linux Programmer's Manual"
 .SH NAME
 getwchar \- read a wide character from standard input
 .SH SYNOPSIS
 .nf
 .B #include <wchar.h>
-.sp
+.PP
 .B "wint_t getwchar(void);"
 .fi
 .SH DESCRIPTION
@@ -27,25 +29,44 @@ The
 function is the wide-character equivalent of the
 .BR getchar (3)
 function.
-It reads a wide character from \fIstdin\fP and returns
+It reads a wide character from
+.I stdin
+and returns
 it.
-If the end of stream is reached, or if \fIferror(stdin)\fP becomes
-true, it returns
+If the end of stream is reached, or if
+.I ferror(stdin)
+becomes true, it returns
 .BR WEOF .
 If a wide-character conversion error occurs, it sets
-\fIerrno\fP to \fBEILSEQ\fP and returns
+.I errno
+to
+.B EILSEQ
+and returns
 .BR WEOF .
 .PP
 For a nonlocking counterpart, see
 .BR unlocked_stdio (3).
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR getwchar ()
 function returns the next wide-character from
 standard input, or
 .BR WEOF .
-.SH "CONFORMING TO"
-C99.
+.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 getwchar ()
+T}     Thread safety   MT-Safe
+.TE
+.sp 1
+.SH CONFORMING TO
+POSIX.1-2001, POSIX.1-2008, C99.
 .SH NOTES
 The behavior of
 .BR getwchar ()
@@ -59,6 +80,6 @@ It is reasonable to expect that
 will actually
 read a multibyte sequence from standard input and then
 convert it to a wide character.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR fgetwc (3),
 .BR unlocked_stdio (3)