[bug #63150] [man pages] set summary-description terms in italics as needed

[G. Branden Robinson]

Update of bug #63150 (project groff):

                  Status:             In Progress => Fixed                  
             Open/Closed:                    Open => Closed                 
         Planned Release:                    None => 1.23.0                 

    _______________________________________________________

Follow-up Comment #3:


commit 0513b50e82ccf348dfee8131b60da8865e059d4e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Thu Oct 13 04:55:52 2022 -0500

    eqn(1): Fix content and style nits.
    
    * Set terms in italics in summary-description (Savannah #63150).
[...]

commit 54c8efab20e4bc5b239d145c7fa9ffe70c2a15ea
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Tue Oct 18 09:27:03 2022 -0500

    afmtodit(1): Fix ordering error.
    
    Fixes <https://savannah.gnu.org/bugs/?63228>.  Thanks to Bjarni Ingi
    Gislason for the report.
    
    Also set terms in italics in summary-description (Savannah #63150), and
    recast a little.

commit fa57adaf0b437315805d6cc326414c9abfb654b2
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Thu Nov 3 09:59:07 2022 -0500

    groff_mdoc(7): Revise introductory subsections.
    
    Content:
    * Say something good about mdoc; its semantic emphasis has prevented the
      effloresence of inconsistent style markup exhibited by man(7) pages.
    * Say 'section "headings"', not "headers".  The header is formatted at
      the top of the page and is the counterpart of the footer.  A "heading"
      organizes paragraphs.
    * Introduce right-arrow notation convention so we can present examples
      more compactly.
    * Stop referring to a dot in a laborious manner.
    * Convert inline examples to use new arrow convention.
    * Refer to "words", not "strings".  "Strings" are a roff language
      element that we should not introduce in inappropriate contexts.
    * Break input lines after commas.
    * Wrap long input lines.
    
    Style:
    * In summary-description, mark up "roff" with `Xr`.
    * Cross reference groff(1) man page in introduction.
    * Set subsection headings in sentence case and update `Sx` cross refs.
    * Tighten wording.

commit d72b4b7b945a54093811f498739f09c647be6812
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sun Oct 30 19:44:51 2022 -0500

    [man pages]: Update summary descriptions.
    
    * Set names of groff programs (or "roff") and macro packages in italics.
    * Spell "grap" and "pic" in lowercase.
    * Capitalize "Gremlin" when referring to the file format.
    * Drop unnecessary input line continuation.
    * Name output driver command name instead of groff option with argument.
    * Stop implying that groff's me(7) is restricted to use with groff; it's
      supposed to work in compatibility mode, too, and therefore with other
      *roffs.



    _______________________________________________________

Reply to this item at:

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

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