[groff] 03/72: afmtodit(1): Fix content nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 3e84391a0b5c3b6cfd579c971036569b4766275e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Oct 18 11:13:28 2022 -0500

    afmtodit(1): Fix content nits.
    
    * Be more specific: groff ordinary or special character names can be
      used as target mappings.  Clarify how classification is determined.
    * Use `groff-char` instead of `groff-glyph` as metasyntactic variable;
      see commit 9736359727, 11 October, for rationale.
    * Add cross reference to groff_char(7).
    * Adjust advice regarding unencoded glyph indices.
---
 src/utils/afmtodit/afmtodit.1.man | 31 +++++++++++++++++--------------
 1 file changed, 17 insertions(+), 14 deletions(-)

diff --git a/src/utils/afmtodit/afmtodit.1.man 
b/src/utils/afmtodit/afmtodit.1.man
index 0a083237f..daf73b95b 100644
--- a/src/utils/afmtodit/afmtodit.1.man
+++ b/src/utils/afmtodit/afmtodit.1.man
@@ -83,7 +83,7 @@ output devices of
 .I map-file
 associates a
 .I groff
-glyph name with a PostScript glyph name.
+ordinary or special character name with a PostScript glyph name.
 .
 Output is written in
 .MR groff_font @MAN5EXT@
@@ -103,26 +103,27 @@ should contain a sequence of lines of the form
 .
 .RS
 .EX
-.I ps-glyph groff-glyph
+.I ps-glyph groff-char
 .EE
 .RE
 .
 where
 .I ps-glyph
 is the PostScript glyph name and
-.I groff-glyph
-is the
+.I groff-char
+is a
 .I groff
-special character identifier for the glyph
-(as used in the
-.I groff
-font description file).
+ordinary
+(if of unit length)
+or special
+(if longer)
+character identifier.
 .
 The same
 .I ps-glyph
 can occur multiple times in the file;
 each
-.I groff-glyph
+.I groff-char
 must occur at most once.
 .
 Lines starting with \[lq]#\[rq] and blank lines are ignored.
@@ -136,9 +137,9 @@ subdirectory of the default font directory.
 .LP
 If a PostScript glyph is not mentioned in
 .IR map-file ,
-and a generic
+and a
 .I groff
-glyph name can't be deduced using the Adobe Glyph List
+character name can't be deduced using the Adobe Glyph List
 (AGL,
 built into
 .IR afmtodit ),
@@ -171,9 +172,11 @@ Refer to section \[lq]Using Symbols\[rq] in
 the
 .I groff
 Texinfo manual,
-which describes how
+or
+.MR groff_char @MAN7EXT@ ,
+which describe how
 .I groff
-glyph names are constructed.
+character identifiers are constructed.
 .
 .
 .LP
@@ -190,7 +193,7 @@ in the
 font description file.
 .
 Unencoded glyph indices don't have a specific order;
-it is best to access them with glyph names only.
+it is best to access them only via special character identifiers.
 .
 .
 .P