[Groff] UTP Proofreading Fixes

[Michael Hobgood]

        Now that the UTP is in the proofreading stage, I've
a few questions to ask those of you who have performed the work.

        1. If I should find a small error in a file, do you wish for me
to send Larry the fix or send the fix to the person(s) who
originally typed/scanned/marked-up the material?
        2. I've inlined a proposed header to be included in each
individual file. It is along the lines of the GPL statements and
hopefully keeps in the spirit of the open source community.  What
do you think?  Do we want something like this?  If so, comments on
the draft please.
        3. Along with item 1, some consistency work will now need to 
be done.  For instance, the page numbers need to be converted to the
.page xxx macro format, so that those desiring to furnish updated material
have a reference point.  I can change those as I proof the file.  Do
you want this done?
        4. As you will note in the proposed header, I am claiming that
we fixed any errors we found in the original book, if fixing them was
possible; and that we put a note to that effect in the source.  At least
that is what I did.  Do you all agree that this should be done?  I can
easily do this while proofing.
        5. What, if anything, would you like for me to do while I am
proofreading the files?  I am using printed copies of the O'Reilly
pdf files as source documents.  For my own work, I am making sure that
all fonts come as close as possible to what is used in individual chapters
(which are not consistent by the way), cleaning up the .) versus ).
inconsistencies, etc. These are of course, just minor nits. 

        Let me know what you want.  I will do what each individual
wishes.

Cordially
Michael Hobgood

-------------  proposed header for each file-----------------------
  
.ig
        This is v1.0 of the
        preface.t
        file for the Unix Text Processing (UTP) projects
        re-creation of Tim O'Reillys' original book
        "Unix Text Processing."

        O'Reilly & Associates' is given great thanks and credit
        for allowing this project by making the original available
        for reproduction.  

        This file was scanned/typed/marked-up by: Stewart Russell.
        The addendum was added by: Larry Kollar.
        Proofreading was done by: Michael Hobgood

        During the recreation of this book, all errors found
        in the original have been corrected, if possible.
        Any remaining errors may be claimed by the individuals
        doing the final proof-reading. Report any errors found
        to the groff mailing list at:
        address@hidden

        While attempts were made to get the recreation as close
        to the original as possible, some changes have been made.
        These changes are cosmetic only; all original content
        has been preserved. Additionally, some inconsistentcies
        in the original were corrected in this recreation.
        Changes were driven primarily by two forces:
                1. Not having the exact macros used in the original.
                2. Differences in fonts, paper sizes, etc.
        These forces precluded generating an exact duplicate.

        Since this is a reproduction of a 1987 era book,
        a need for updates to align the material with the
        current groff version of the troff typesetting 
        program exists. Note that no updates are included in
        this reproduction, therefore, some of what is
        contained is out of date.  Consult the groff
        documentation if what is presented in this book
        doesn't work as advertised.
                
        A note about lines begining with ".page xxx".
        These page numbers refer to the original page numbers,
        not to the page number obtained when the book is 
        formatted with groff.  Page numbers produced by the
        .page xxx macro are intended to assist in making
        future updates to this book.  To display them in the
        left margin, insert the troff command .do-page
        immediately after the .utp command before formatting
        the book.

        To groff the entire book from the tarball, use:
        groff -step -ms utp_book.t > utp_book.ps
        The file utp.mac must be available either in the directory
        where the source file is located, or groff must be told
        where to find it.
        To format this file individually, use:
        groff -ms preface.t > preface.ps
        Again, the file utp.mac must be present.
..