[PATCH][BZ #6885] Clarify description of __freading and __fwriting

[Siddhesh Poyarekar <siddhesh at redhat dot com>]

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