[bug #62551] [PATCH] doc/groff.texi: Fix content and style nits

[G. Branden Robinson]

Update of bug #62551 (project groff):

                  Status:                    None => In Progress            
             Assigned to:                    None => gbranden               

    _______________________________________________________

Follow-up Comment #1:

Thanks, Dave!

[comment #0 original submission:]
> Possible controversial points about this patch:
> 
> * In a couple cases I removed what I consider to be excess verbiage; if you
feel any removed wording removes useful information, feel free to excise that
part of the patch.
> 
> * The Chicago Manual of Style (see the answer to the first question on
http://www.chicagomanualofstyle.org/qanda/data/faq/topics/WordDivision.html)
says it is "advisable to avoid a break... before (but not after) a middle
initial."  This is the opposite of what was being done with the names Trent A.
Fisher and Eric P. Allman.  The name J. F. Ossanna did follow CMOS style
here.
> 
> CMOS is not universally accepted, but I can also justify this styling on
purely typographic grounds if necessary (but I won't bore you if not).

I'm okay with it.  I have a voodoo doll of Russell Harper but that doesn't
mean I think CMOS is categorically wrong.
 
> The name Jerome H. Saltzer had no tie{}, and I have not added one, presuming
its omission was intentional based on the name's placement on the line. 
(However, one could also argue for marking up names consistently as a
defensive measure.)

The whole "History" node/section is going away in a pending commit anyway--for
once, we got lucky and didn't end up hacking on the same parts of our Texinfo
manual simultaneously.  :)
 
> The name M. E. Lesk had no tie{}.  I added one, presuming this was an
oversight, but it's possible this was also intentional (the name appears
inside a cite{}, if that matters).  This change can also be omitted if it
serves no purpose.

As far as I know, the Texinfo @cite command has no impact on text flow or
layout.  (My knowledge of Texinfo is shallow, however.)

> Trent's name appears in the manual's list of authors, and I can't find where
the author list (or any of the titlepage information) is actually displayed,
either through the info(1) interface, or in the groff.txt file generated by
the build.  So the placement of this tie{} may make no real-world difference.

Cover page material seems only to appear in DVI and PDF output, so, no, I
guess it doesn't make any difference.  It's conceivable that a future Texinfo
may include these data in other output formats, and since it's anyone's guess
what layout may eventuate, the conservative approach of adding the tie seems
prudent to me.

As you probably saw, Trent's name does appear in an example in the manual, but
as unfilled text, so a tie would be superfluous there.

Good stuff here, including fixes for some errors I think I introduced.  Thank
you!


    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?62551>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/