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 third status update to the copyediting effort.

        I have prepared the fourth set of proofs (RC3): 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.

        GCC 3.3 is about to release, either today or tomorrow.  Jim
Morrison is feeding patches upstream as fast as he can, in hopes of
getting our corrections into the release tarball.  Jim, if you need any
help, please let us know.

        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:

Lisa Goldstein          Editing gcc.004.pdf, Edited gcc.003.pdf
Stephen Compall         Edited gcc.005.pdf
Paul Crable             Editing gcc.{001,002,006,008}.pdf
Rob Hughes              Edited gcc.010.pdf
Dan Colascione          Edited gcc.016.pdf and gcc.017.pdf
Dave Fluri              Editing gcc.{019,020}.pdf, edited gcc.{011,018}.pdf
Phil Mcc                Editing gcc.012.pdf and gcc.013.pd      f
J. Otto Tennant         Edited gcc.003.pdf and gcc.017.pdf

        Currently, the following sections still need volunteers:

gcc.001.pdf
gcc.002.pdf
gcc.004.pdf
gcc.005.pdf
gcc.006.pdf
gcc.007.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.014.pdf
gcc.015.pdf gcc.015.pdf
gcc.016.pdf
gcc.017.pdf
gcc.018.pdf
gcc.019.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

    In order to build a DVI of the manual for the press, use:
        bash-2.05b$ texi2dvi address@hidden -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-05-09  J. Otto Tennant  <address@hidden>

        * doc/invoke.texi: Fixed minor spacing error.

2003-05-09  J. Otto Tennant  <address@hidden>

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

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

        * doc/invoke.texi: Re-arranged option lists for M68h1x,
        VAX, and ARM.  Fixes to spelling, grammar, and diction.
        Re-arranged -mcmodel, -mcode-model, and -msdata options.

2003-05-10  Rob Hughes  <address@hidden>

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

2003-05-09  J. Otto Tennant  <address@hidden>

        * doc/bugreport.texi: Fixes to spelling, grammar, and diction.
        * doc/trouble.texi: Fix linebreaking across variables.

2003-05-13  Simon Law  <address@hidden>

        * doc/contrib.texi: Better formatting for long names.

2003-05-11  Peter Kaiser  <address@hidden>

        * doc/cpp.texi: Use `prefix' instead of the hackish `prepend.'
        * doc/cppinternals.texi: As above.
        * doc/cppopts.texi: As above.
        * doc/extend.texi: As above.
        * doc/install.texi: As above.
        * doc/invoke.texi: As above.