Re: [Bug-gnupress] Thank you for offering to proofread "Using GCC"

[Simon Law]

Dear volunteers,

Thank you to the people from address@hidden who are volunteering
their time.  This is the second status update to the copyediting effort.

        I have prepared the third set of proofs (RC2): these incorporate
changes from GCC's 3.3 CVS branch, and the recent patches which are
appended to the end of this message.  You may also note that some of
sections have grown or shrunk, this is due to GCC developers adding more
text.  Since each PDF is 20 pages long, some of the sections have have
moved across PDFs.  It does not appear that there has been too much that
has changed, so proofreading each section should still be fine.

        You may find these proofs in PDF form at the following URLs.

http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.001.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.002.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.003.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.004.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.005.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.006.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.007.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.008.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.009.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.010.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.011.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.012.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.013.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.014.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.015.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.016.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.017.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.018.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.019.pdf
http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.020.pdf

        Currently, I have recorded the following volunteers:

Ciaran O'Riordan
James Howison           Editing gcc.007.pdf and gcc.014.pdf
Richard Kreuter
Lisa Goldstein          Editing gcc.004.pdf, Edited gcc.003.pdf
Stephen Compall         Edited gcc.005.pdf
Alexandros Papadopoulos Editing gcc.016.pdf and gcc.017.pdf
Jack Nerad              Editing gcc.001.pdf and gcc.002.pdf
Paul Crable             Editing gcc.{001,002,008}.pdf, edited gcc.006.pdf
Rob Hughes              Editing gcc.010.pdf
Dan Colascione          Edited gcc.016.pdf and gcc.017.pdf
Dave Fluri              Editing gcc.018.pdf, edited gcc.011.pdf
Phil Mcc                Editing gcc.012.pdf and gcc.013.pdf

        Currently, the following sections still need volunteers:

gcc.003.pdf
gcc.004.pdf
gcc.005.pdf
gcc.006.pdf
gcc.007.pdf
gcc.008.pdf
gcc.009.pdf gcc.009.pdf
gcc.010.pdf
gcc.011.pdf
gcc.012.pdf
gcc.013.pdf
gcc.014.pdf
gcc.015.pdf gcc.015.pdf
gcc.016.pdf
gcc.017.pdf
gcc.018.pdf
gcc.019.pdf gcc.019.pdf
gcc.020.pdf gcc.020.pdf

        We hope that each person edits two sections.  I'd suggest that
you pick a section that has not yet been edited, and do that.  We aim
for each section to be edited by two different people.

        I do not think that the GNU has an official style.  However, GCC
itself does have a small style guide which can be found in the
"Spelling, terminology and markup" section of this webpage:
http://gcc.gnu.org/codingconventions.html

        Once you are finished editing a portion, please e-mail the
mailing list with the section you edited, and any corrections that need
to be made.  You may either send a patch directly against the Texinfo
source [1]; or you may use standard errata notation like so:

    p. 15, line 10: "...something up with which we will not put." 
    should read "...something we will not put up with."

        You may notice black boxes in the right margin.  These boxes are
inserted by Texinfo to show that a line is extending into the right
margin.  If the protrusion is not noticable, ignore it.  If it is
unsightly, please suggest an alternate wording that allows the line to
wrap in a nicer fashion.

        Thanks again.

Simon

-----
[1] A tarball of the sources I used to generate the PDFs is available
    at http://www.csclub.uwaterloo.ca/~sfllaw/using-gcc/gcc.tar.bz2

    You will need to have checked out the GNU Press CVS repository.
    I have checked mine into the ~/gnupress directory.  In order to
    build a DVI of the manual:
        bash-2.05b$ texi2dvi -I ~/gnupress/texpress -I . -I include gcc.texi

    To view the DVI:
        bash-2.05b$ xdvi -paper 7x9.25in gcc.dvi

    To build the PDF from that, use:
        bash-2.05b$ dvipdf gcc.dvi

Patches I have applied
======================

2003-04-23  Lisa M. Opus Goldstein  <address@hidden>

        * doc/invoke.texi: Fixes to style, grammar and diction.

2003-04-23  Simon Law  <address@hidden>

        * doc/cppopts.texi (-Wall): Clarify the comment about default 
        warnings.

        * doc/invoke.texi (-l): Re-word the section on POSIX compliance.
        Mention the linker's preference for shared libraries.

2003-04-24  Dave Fluri  <address@hidden>

        * doc/extend.texi: Fixes to spelling, grammar, and diction.

2003-04-25  Dan Colascione  <address@hidden>

        * doc/bugreport.texi: Fixes to spelling, grammar, and diction.
        * doc/compat.texi: As above.
        * doc/gcov.texi: As above.
        * doc/trouble.texi: As above.

2003-04-28  Dave Fluri  <address@hidden>

        * doc/vms.texi: Fixes to spelling, grammar, and diction.
        * doc/gnu.texi: As above.

2003-05-03  Paul A. Crable  <address@hidden>

        * doc/invoke.texi: Fixes to spelling, grammar, and diction.