[groff] 06/10: [docs]: Clarify italic correction material.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 9ec882babacc440fb43226ca31705201e4a834a4
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Sep 25 22:13:11 2021 +1000

    [docs]: Clarify italic correction material.
    
    * Make it clear that a subscript correction is intended to be applied
      only to oblique glyphs.
    * Lose the description of glyph lists in charset subsections as
      "ordered"; it is, but it's a mere partial ordering and that only if
      you use aliases.
    * Tighten wording.
    * Fix missing thin space between end of ellipsis and comma in man page.
    * Improve sync between Texinfo nodes and groff_font(5).
---
 doc/groff.texi       | 29 ++++++++++++++---------------
 man/groff_font.5.man | 39 ++++++++++++++++++---------------------
 2 files changed, 32 insertions(+), 36 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index eb1c0fb..48bd9bb 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -17882,7 +17882,7 @@ The default font family is @var{fam}.
 
 @item fonts @var{n} @var{F1} @r{@dots{}} @var{Fn}
 @kindex fonts
-Fonts @var{F1} @dots{} @var{Fn} are mounted in the font positions
+Fonts @var{F1}, @dots{}, @var{Fn} are mounted at font positions
 @var{m}+1, @dots{}, @var{m}+@var{n} where @var{m} is the number of
 @code{styles} (see below).  This directive may extend over more than one
 line.  A font name of@tie{}@code{0} causes no font to be mounted at the
@@ -18134,10 +18134,10 @@ is optional.
 @kindex charset
 The directive @code{charset} starts the character set
 subsection.@footnote{For typesetter devices, this keyword is misnamed
-since it starts an ordered list of glyphs, not characters.}  The
-@code{charset} line is followed by a sequence of lines, each with
-information about one glyph.  A line comprises a number of fields
-separated by spaces or tabs.  The format is as follows.
+since it starts a list of glyphs, not characters.}  It precedes a series
+of glyph descriptions, one per line.  Each such glyph description
+comprises a set of fields separated by spaces or tabs and organized as
+follows.
 
 @quotation
 @var{name} @var{metrics} @var{type} @var{code} [@var{entity-name}]
@@ -18211,14 +18211,13 @@ glyph, that is, the distance below the baseline to 
which the glyph
 extends (downwards is positive); if a glyph does not extend below the
 baseline, it should be given a zero depth, rather than a negative depth.
 Italic corrections are relevant to glyphs in italic or oblique styles.
-The @var{italic-correction} subfield gives the amount of space that
-should be added after the glyph when it is to be immediately followed by
-a glyph from an upright style.  The @var{left-italic-correction}
-subfield gives the amount of space that should be added before the glyph
-when it is to be immediately preceded by a glyph from an upright style.
-The @var{subscript-correction} gives the amount of space that should be
-added after a glyph before adding a subscript.  This should be less than
-the italic correction.
+The @var{italic-correction} is the amount of space that should be added
+after an oblique glyph to be followed immediately by an upright glyph.
+The @var{left-italic-correction} is the amount of space that should be
+added before an oblique glyph to be preceded immediately by an upright
+glyph.  The @var{subscript-correction} is the amount of space that
+should be added after an oblique glyph to be followed by a subscript; it
+should be less than the italic correction.
 
 The @var{type} field gives a featural description of the glyph.
 
@@ -18230,8 +18229,8 @@ means the glyph has a descender (for example, @samp{p});
 means the glyph has an ascender, (for example, @samp{b}); and
 
 @item 3
-means the glyph has both an ascender and a descender (for example, this
-is true of parentheses in some fonts).
+means the glyph has both an ascender and a descender (for example,
+parentheses in some fonts).
 @end table
 
 The @var{code} field gives a numeric identifier that the postprocessor
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 6e58a6a..1ee2312 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -128,8 +128,8 @@ The default font family is
 .BI fonts\~ "n F1"\~\c
 .RI .\|.\|.\&\~ Fn
 Fonts
-.IR F1 ", \|.\|.\|., " Fn
-are mounted in the font positions
+.IR F1 ", \|.\|.\|.\|, " Fn
+are mounted at font positions
 .IR m "\|+\|1, \|.\|.\|., " m \|+\| n
 where
 .I m
@@ -653,20 +653,17 @@ is optional.
 .P
 The directive
 .B charset
-starts the charset subsection.
+starts the character set subsection.
 .
 (For typesetter devices,
-this keyword is a misnomer since it starts an ordered list of glyphs,
+this keyword is a misnomer since it starts a list of glyphs,
 not characters.)
 .
-The
-.B charset
-line is followed by a sequence of lines,
-each with information about one glyph.
-.
-A line comprises a number of fields separated by spaces or tabs.
+It precedes a series of glyph descriptions,
+one per line.
 .
-The format is as follows.
+Each such glyph description comprises a set of fields separated by
+spaces or tabs and organized as follows.
 .
 .
 .IP
@@ -776,20 +773,20 @@ Italic corrections are relevant to glyphs in italic or 
oblique styles.
 .
 The
 .I italic-correction
-subfield gives the amount of space that should be added after the glyph
-when it is to be followed immediately by a glyph from an upright style.
+is the amount of space that should be added after an oblique glyph to be
+followed immediately by an upright glyph.
 .
 The
 .I left-italic-correction
-subfield gives the amount of space that should be added before the glyph
-when it is to be preceded immediately by a glyph from an upright style.
+is the amount of space that should be added before an oblique glyph to
+be preceded immediately by an upright glyph.
 .
 The
-.I subscript-correction
-gives the amount of space that should be added after a glyph before
-adding a subscript.
-.
-This should be less than the italic correction.
+.I
+subscript-correction
+is the amount of space that should be added after an oblique glyph to be
+followed by a subscript;
+it should be less than the italic correction.
 .
 .
 .P
@@ -817,7 +814,7 @@ and
 3
 means the glyph has both an ascender and a descender
 (for example,
-this is true of parentheses in some fonts).
+parentheses in some fonts).
 .
 .
 .P