This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
[PATCH][BZ #6885] Clarify description of __freading and __fwriting
- From: Siddhesh Poyarekar <siddhesh at redhat dot com>
- To: libc-alpha at sourceware dot org
- Date: Thu, 13 Dec 2012 18:37:10 +0530
- Subject: [PATCH][BZ #6885] Clarify description of __freading and __fwriting
Hi,
The patch below makes the descriptions of __freading and __fwriting a
bit clearer. OK to commit (I assume after the freeze is lifted)?
Siddhesh
ChangeLog:
[BZ #6885]
* manual/stdio.texi (__freading): Clarify description.
(__fwriting): Likewise.
diff --git a/manual/stdio.texi b/manual/stdio.texi
index 7b436f0..a276422 100644
--- a/manual/stdio.texi
+++ b/manual/stdio.texi
@@ -364,11 +364,10 @@ They provide even finer-grained information.
@comment stdio_ext.h
@comment GNU
@deftypefun int __freading (FILE *@var{stream})
-The @code{__freading} function determines whether the stream
-@var{stream} was last read from or whether it is opened read-only. In
-this case the return value is nonzero, otherwise it is zero.
-Determining whether a stream opened for reading and writing was last
-used for writing allows to draw conclusions about the content about the
+The @code{__freading} function returns a nonzero value if the stream
+@var{stream} was last read from or is opened read-only. Otherwise the function
+returns zero. Determining whether a stream opened for reading and writing was
+last used for writing allows to draw conclusions about the content about the
buffer, among other things.
This function is declared in @file{stdio_ext.h}.
@@ -377,9 +376,9 @@ This function is declared in @file{stdio_ext.h}.
@comment stdio_ext.h
@comment GNU
@deftypefun int __fwriting (FILE *@var{stream})
-The @code{__fwriting} function determines whether the stream
-@var{stream} was last written to or whether it is opened write-only. In
-this case the return value is nonzero, otherwise it is zero.
+The @code{__fwriting} function returns a nonzero value if the stream
+@var{stream} was last written to or is opened write-only. Otherwise the
+function returns zero.
This function is declared in @file{stdio_ext.h}.
@end deftypefun
--
1.7.11.7