(split) LDP: Update original to LDP v3.65

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

diff --git a/original/man3/fgetws.3 b/original/man3/fgetws.3
index 3a7d7a6..f25eb67 100644 (file)
--- a/original/man3/fgetws.3
+++ b/original/man3/fgetws.3
@@ -1,19 +1,21 @@
 .\" 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
+.\"   OpenGroup's Single UNIX specification
 .\"     http://www.UNIX-systems.org/online.html
 .\"   ISO/IEC 9899:1999
 .\"
 .\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk>
-.TH FGETWS 3  1999-07-25 "GNU" "Linux Programmer's Manual"
+.TH FGETWS 3  2011-09-28 "GNU" "Linux Programmer's Manual"
 .SH NAME
 fgetws \- read a wide-character string from a FILE stream
 .SH SYNOPSIS
@@ -31,7 +33,7 @@ of the
 function.
 It reads a string of at most \fIn\-1\fP wide characters into the
 wide-character array pointed to by \fIws\fP,
-and adds a terminating L\(aq\\0\(aq character.
+and adds a terminating null wide character (L\(aq\\0\(aq).
 It stops reading wide characters after it has encountered and
 stored a newline wide character.
 It also stops when end of stream is reached.
@@ -41,13 +43,13 @@ characters at \fIws\fP.
 .PP
 For a nonlocking counterpart, see
 .BR unlocked_stdio (3).
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR fgetws ()
 function, if successful, returns \fIws\fP.
 If end of stream
 was already reached or if an error occurred, it returns NULL.
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 C99, POSIX.1-2001.
 .SH NOTES
 The behavior of
@@ -68,6 +70,14 @@ from the stream and then convert it to a wide-character string.
 This function is unreliable,
 because it does not permit to deal properly with
 null wide characters that may be present in the input.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR fgetwc (3),
 .BR unlocked_stdio (3)
+.SH COLOPHON
+This page is part of release 3.65 of the Linux
+.I man-pages
+project.
+A description of the project,
+and information about reporting bugs,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.