Re: PATCH: copy-edit File-I/O section of manual

[Sandra Loosemore <sandra at codesourcery dot com>]

Eli Zaretskii wrote:

> If you can present the patch in a way that makes this big picture
> show, it might help me review the patch sooner.  Based on my
> experience, such a presentation will need to use something other than
> Diff, though.

Would it help if I listed some of the changes I made?

* I fixed several spelling errors; e.g., replacing "interupt" with "interrupt", 
"approriate" with "appropriate".
* I fixed several verb tense errors, e.g. replacing "send" with "sent" in many 
places.
* I fixed some places where an adjective was used where an adverb was required, 
e.g., replacing "successful" with "successfully", "reliable" with "reliably".
* There were several places where commas were used incorrectly, often in 
combination with awkward phrasing of the sentence as a whole.  I fixed these.
* I fixed some other instances of awkward grammar, sentence construction, or 
word choice.
* I moved the three sections of text I mentioned in a previous message to 
combine related information in one place.  I updated the section menus to 
reflect these moves.
* I changed the formatting of the sections describing individual calls to use 
@table instead of a mishmash of @smallexample, @exdent, and regular running 
text.  This fixed problems with, for example, the return value descriptions 
being typeset as examples instead of as descriptive text in normal font.
* In combination with the above, I put references to parameters in the running 
text in @var{} and references to function names, type names, and symbolic 
constants in @code{}.

> You are asking me to proofread a large portion of text, instead of
> concentrating on the relatively small differences.

Well, you were complaining that the diffs were too big, and the "large portion" 
of text is only 12 pages.

-Sandra