[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[bug #53788] afmtodit.1.man: Split long strings to avoid repetition and
From: |
G. Branden Robinson |
Subject: |
[bug #53788] afmtodit.1.man: Split long strings to avoid repetition and a warning |
Date: |
Wed, 15 Jun 2022 10:29:03 -0400 (EDT) |
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/
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [bug #53788] afmtodit.1.man: Split long strings to avoid repetition and a warning,
G. Branden Robinson <=