[bug #53788] afmtodit.1.man: Split long strings to avoid repetition and a warning

[G. Branden Robinson]

Update of bug #53788 (project groff):

                Category:                    None => Font devps             
                 Summary: [PATCH] afmtodit.1.man: Split long strings to avoid
repetition and a  warning => afmtodit.1.man: Split long strings to avoid
repetition and a  warning

    _______________________________________________________

Follow-up Comment #2:

I applied my own fixes, preserving the textual replacement of special
sequences like @FONTDIR@ with the values of Make macros in man page sources.


commit 1816eac38dc831030ec8a203e114ed9a28776a4f
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Mon Nov 5 04:55:23 2018 -0500

    afmtodit(1): Make style fixes.
    
            * src/utils/afmtodit/afmtodit.1.man:
              + Use hyphens instead of underscores in option argument names;
                they are prose, not C identifiers.
              + Capitalize "Perl" except when referring to its man page.
              + Mark up short character literals with single quotation
                marks, not bold (e.g., '#', '\N', '-1').
              + Fix direct object confusion: "searched" -> "searched for".
              + Mark up file/path names in italics, not with quotation
                marks.
              + Clarify: "troff" -> "a roff document".
              + Clarify recognition of glyph variant names.
              + Mark up section titles and very short examples with double
                quotation marks.
              + Use comma before "which" in nonrestrictive dependent clause;
                see <https://www.grammarly.com/blog/comma-before-which/>.
              + Move notice of optional whitespace between options and their
                arguments from Synopsis to Options section.
              + Capitalize "AFM" when used as an initialism.
              + Change the one occurrence of "PS" to PostScript; the full
                term is ubiquitous throughout the page.
              + Tighten descriptions of -k and -n options.
              + Consistently use the phrase "monospaced (constant-width)",
                making their synonymy clear, instead of using one or the
                other variously.
              + Clarify that the -v option exits the program without
                performing its usual operations.
              + Use .EX/.EE to mark up example of AFM file contents.
              + Add hyphenless discretionary breaks to filename components
                (i.e., after each "/").  Thanks to Bjarni Ingi Gislason for
                noticing the problem here.  Fixes
                <https://savannah.gnu.org/bugs/index.php?53788>.
              + Cite groff Texinfo manual more completely in "See Also"
                section.  Tell readers how to load the referenced node.
              + Add cross-reference to gropdf(1) to "See Also" section.



    _______________________________________________________

Reply to this item at:

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

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