This is the mail archive of the
glibc-cvs@sourceware.org
mailing list for the glibc project.
GNU C Library master sources branch, master, updated. glibc-2.15-236-g6664049
- From: jsm28 at sourceware dot org
- To: glibc-cvs at sourceware dot org
- Date: 27 Feb 2012 20:38:03 -0000
- Subject: GNU C Library master sources branch, master, updated. glibc-2.15-236-g6664049
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU C Library master sources".
The branch, master has been updated
via 6664049b71f562ffbf77f96cf6a7521aa6135ed2 (commit)
from bb8b6697d419a9ed48b96470844aa0b6c84435e3 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://sources.redhat.com/git/gitweb.cgi?p=glibc.git;a=commitdiff;h=6664049b71f562ffbf77f96cf6a7521aa6135ed2
commit 6664049b71f562ffbf77f96cf6a7521aa6135ed2
Author: Joseph Myers <joseph@codesourcery.com>
Date: Mon Feb 27 20:37:48 2012 +0000
Don't document fclean.
diff --git a/ChangeLog b/ChangeLog
index 77e4921..5e785da 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
2012-02-27 Joseph Myers <joseph@codesourcery.com>
+ * manual/llio.texi (fclean): Remove documentation.
+
+2012-02-27 Joseph Myers <joseph@codesourcery.com>
+
* manual/Makefile (libc-texi-generated): New variable. Include
version.texi.
(libc.dvi, libc.pdf, libc.info, libc/index.html): Depend on
diff --git a/manual/llio.texi b/manual/llio.texi
index 8154de7..281d1e0 100644
--- a/manual/llio.texi
+++ b/manual/llio.texi
@@ -1000,21 +1000,10 @@ for linked channels; see @ref{Linked Channels}.
@node Cleaning Streams
@subsection Cleaning Streams
-On the GNU system, you can clean up any stream with @code{fclean}:
-
-@comment stdio.h
-@comment GNU
-@deftypefun int fclean (FILE *@var{stream})
-Clean up the stream @var{stream} so that its buffer is empty. If
-@var{stream} is doing output, force it out. If @var{stream} is doing
-input, give the data in the buffer back to the system, arranging to
-reread it.
-@end deftypefun
-
-On other systems, you can use @code{fflush} to clean a stream in most
+You can use @code{fflush} to clean a stream in most
cases.
-You can skip the @code{fclean} or @code{fflush} if you know the stream
+You can skip the @code{fflush} if you know the stream
is already clean. A stream is clean whenever its buffer is empty. For
example, an unbuffered stream is always clean. An input stream that is
at end-of-file is clean. A line-buffered stream is clean when the last
@@ -1028,12 +1017,10 @@ not random access, there is no way to give back the excess data already
read. When an input stream reads from a random-access file,
@code{fflush} does clean the stream, but leaves the file pointer at an
unpredictable place; you must set the file pointer before doing any
-further I/O. On the GNU system, using @code{fclean} avoids both of
-these problems.
+further I/O.
Closing an output-only stream also does @code{fflush}, so this is a
-valid way of cleaning an output stream. On the GNU system, closing an
-input stream does @code{fclean}.
+valid way of cleaning an output stream.
You need not clean a stream before using its descriptor for control
operations such as setting terminal modes; these operations don't affect
-----------------------------------------------------------------------
Summary of changes:
ChangeLog | 4 ++++
manual/llio.texi | 21 ++++-----------------
2 files changed, 8 insertions(+), 17 deletions(-)
hooks/post-receive
--
GNU C Library master sources