[groff] 20/37: [afmtodit]: Align man page and usage message.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit d0c0a50aa22e72fec28a46d091bbec020c87cb4c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Mar 8 08:23:49 2022 +1100

    [afmtodit]: Align man page and usage message.
    
    * src/utils/afmtodit/afmtodit.1.man:
    * src/utils/afmtodit/afmtodit.pl: Update and align man page synopsis,
      option descriptions, and command usage output.
---
 ChangeLog                         |  6 ++++++
 src/utils/afmtodit/afmtodit.1.man | 34 +++++++++++++++++-----------------
 src/utils/afmtodit/afmtodit.pl    |  7 ++++---
 3 files changed, 27 insertions(+), 20 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 0f0ba3a8..0ba62d5a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2022-03-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * src/utils/afmtodit/afmtodit.1.man:
+       * src/utils/afmtodit/afmtodit.pl: Update and align man page
+       synopsis, option descriptions, and command usage output.
+
 2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * tmac/X.tmac: Redirect `fchar` requests for \[lq] and \[rq] to
diff --git a/src/utils/afmtodit/afmtodit.1.man 
b/src/utils/afmtodit/afmtodit.1.man
index 24a232ec..b4511f23 100644
--- a/src/utils/afmtodit/afmtodit.1.man
+++ b/src/utils/afmtodit/afmtodit.1.man
@@ -37,20 +37,20 @@ afmtodit \- adapt Adobe Font Metrics files for groff \-Tps 
and \-Tpdf
 .SY afmtodit
 .RB [ \-ckmnsx ]
 .RB [ \-a\~\c
-.IR n ]
+.IR slant ]
 .RB [ \-d\~\c
-.IR desc-file ]
+.IR device-description-file ]
 .RB [ \-e\~\c
-.IR enc-file ]
+.IR encoding-file ]
 .RB [ \-f\~\c
 .IR internal-name ]
 .RB [ \-i\~\c
-.IR n ]
+.IR italic-correction-factor ]
 .RB [ \-o\~\c
 .IR output-file ]
 .I afm-file
 .I map-file
-.I font-description
+.I font-description-file
 .YS
 .
 .
@@ -83,7 +83,7 @@ glyph name with a PostScript glyph name.
 Output is written in
 .MR groff_font @MAN5EXT@
 format to
-.I font-description,
+.I font-description-file,
 a file named for the intended
 .I groff
 font name
@@ -241,7 +241,7 @@ meaning that
 should search it whenever a glyph is not found in the current font.
 .
 In that case,
-.I font-description
+.I font-description-file
 should be listed as an argument to the
 .B fonts
 directive in the output device's
@@ -259,10 +259,10 @@ will automatically mount it when it is first used.
 .\" ====================================================================
 .
 .TP
-.BI \-a\~ n
+.BI \-a\~ slant
 Use
-.I n
-as the slant parameter in the font description file;
+.I slant
+as the slant (\[lq]angle\[rq]) parameter in the font description file;
 this is used by
 .I groff
 in the positioning of accents.
@@ -289,7 +289,7 @@ font.
 .
 .
 .TP
-.BI \-d\~ desc-file
+.BI \-d\~ device-description-file
 The device description file is
 .I desc-file
 rather than the default
@@ -305,7 +305,7 @@ given with option
 .
 .
 .TP
-.BI \-e\~ enc-file
+.BI \-e\~ encoding-file
 The PostScript font should be reencoded to use the encoding described
 in
 .IR enc-file .
@@ -322,7 +322,7 @@ subdirectory of the default font directory is searched.
 .
 .
 .TP
-.BI \-f\~ name
+.BI \-f\~ internal-name
 The internal name of the
 .I groff
 font is set to
@@ -330,10 +330,10 @@ font is set to
 .
 .
 .TP
-.BI \-i\~ n
+.BI \-i\~ italic-correction-factor
 Generate an italic correction for each glyph so that its width plus its
 italic correction is equal to
-.I n
+.I italic-correction-factor
 thousandths of an em
 plus the amount by which the right edge of the glyph's bounding box is
 to the right of its origin.
@@ -354,7 +354,7 @@ use a subscript correction equal to the italic correction 
instead.
 .
 .IP
 Also generate a left italic correction for each glyph equal to
-.I n
+.I italic-correction-factor
 thousandths of an em
 plus the amount by which the left edge of the glyph's bounding box is to
 the left of its origin.
@@ -381,7 +381,7 @@ for italic fonts.
 Write to
 .I output-file
 instead of
-.I font-description.
+.I font-description-file.
 .
 .
 .TP
diff --git a/src/utils/afmtodit/afmtodit.pl b/src/utils/afmtodit/afmtodit.pl
index 78ba66c8..73ae7c65 100644
--- a/src/utils/afmtodit/afmtodit.pl
+++ b/src/utils/afmtodit/afmtodit.pl
@@ -39,9 +39,10 @@ if ($opt_v) {
 }
 
 if ($#ARGV != 2) {
-    die "usage: $prog [-ckmnsx] [-a ANGLE] [-d DESC-FILE]" .
-       " [-e ENCODING] [-f NAME] [-i N]\n" .
-       " [-o OUT-FILE] AFM-FILE MAP-FILE FONT\n" .
+    die "usage: $prog [-ckmnsx] [-a slant]" .
+       " [-d device-description-file] [-e encoding-file]" .
+       " [-f internal-name] [-i italic-correction-factor]" .
+       " [-o output-file] afm-file map-file font-description-file\n" .
        "usage: $prog -v\n";
 }