[groff] 31/34: [docs]: Update italic correction discussion.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 97419a4d8c89b20e883e64f050a03b9ae748a2e7
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Aug 29 21:03:19 2021 +1000

    [docs]: Update italic correction discussion.
    
    I think I figured out why some people disfavor the term "italic
    correction"; it can apply to oblique typefaces just as well as italic
    ones.  Generalize discussion of "roman" glyphs to "upright" (e.g., *roff
    fonts [styles] "R" and "B") and "oblique" (e.g., *roff "I" and "BI").
    
    There seems to be no alternative term in common use.  "Italic
    correction" has 8.8 million Google hits whereas "oblique correction" has
    few or none on the subject of typography (but I encourage the enthusiast
    of particle physics to check out the Wikipedia article on this term).
---
 doc/groff.texi       | 29 ++++++++++++++---------------
 man/groff_diff.7.man | 18 ++++++++----------
 2 files changed, 22 insertions(+), 25 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 170390d..4b42f4b 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -10691,34 +10691,33 @@ this.
 @Defesc {\\/, , , }
 @cindex italic correction (@code{\/})
 @cindex correction, italic (@code{\/})
-@cindex correction between italic and roman glyph (@code{\/}, @code{\,})
+@cindex correction between oblique and upright glyph (@code{\/}, @code{\,})
 @cindex roman glyph, correction after italic glyph (@code{\/})
-@cindex italic glyph, correction before roman glyph (@code{\/})
-@cindex glyph, italic correction (@code{\/})
-Apply an @dfn{italic correction}: increase the width of the preceding
-glyph so that the spacing between that glyph and the following glyph is
-correct if the following glyph is a roman glyph.  For example, if an
+@cindex upright glyph, correction after oblique glyph (@code{\/})
+Apply an @dfn{italic correction}:@: modify the spacing of the preceding
+glyph so that the distance between it and the following glyph is correct
+if the latter is of upright shape.  For example, if an
 italic@tie{}@samp{f} is immediately followed by a roman right
 parenthesis, then in many fonts the top right portion of
 the@tie{}@samp{f} overlaps the top left of the right parenthesis, which
-is ugly.  Use this escape sequence whenever an italic glyph is
-immediately followed by a roman glyph without any intervening space.
+is ugly.  Use this escape sequence whenever an oblique glyph is
+immediately followed by an upright glyph without any intervening space.
 @endDefesc
 
 @Defesc {\\\,, , , }
 @cindex left italic correction (@code{\,})
 @cindex correction, left italic (@code{\,})
-@cindex glyph, left italic correction (@code{\,})
+@cindex correction between upright and oblique glyph (@code{\/}, @code{\,})
 @cindex roman glyph, correction before italic glyph (@code{\,})
-@cindex italic glyph, correction after roman glyph (@code{\,})
-Apply a @dfn{left italic correction}: modify the spacing of the
-following glyph so that the spacing between that glyph and the preceding
-glyph is correct if the preceding glyph is a roman glyph.  For example,
+@cindex upright glyph, correction before oblique glyph (@code{\,})
+Apply a @dfn{left italic correction}:@: modify the spacing of the
+following glyph so that the distance between it and the preceding
+glyph is correct if the latter is of upright shape.  For example,
 if a roman left parenthesis is immediately followed by an
 italic@tie{}@samp{f}, then in many fonts the bottom left portion of
 the@tie{}@samp{f} overlaps the bottom of the left parenthesis, which is
-ugly.  Use this escape sequence whenever a roman glyph is immediately
-followed by an italic glyph without any intervening space.
+ugly.  Use this escape sequence whenever an upright glyph is followed
+immediately by an oblique glyph without any intervening space.
 @endDefesc
 
 @Defesc {\\&, , , }
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index eaba153..6dd6c5f 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -794,9 +794,8 @@ as arguments.
 .B \[rs]/
 Apply an
 .IR "italic correction" :
-increase the width of the preceding glyph so that the spacing between
-that glyph and the following glyph is correct if the following glyph is
-a roman glyph.
+modify the spacing of the preceding glyph so that the distance between
+it and the following glyph is correct if the latter is of upright shape.
 .
 For example,
 if an italic\~\[lq]f\[rq] is immediately followed by a roman right
@@ -818,17 +817,16 @@ between them
 .\}
 avoids this problem.
 .
-Use this escape sequence whenever an italic glyph is immediately
-followed by a roman glyph without any intervening space.
+Use this escape sequence whenever an oblique glyph is immediately
+followed by an upright glyph without any intervening space.
 .
 .
 .TP
 .B \[rs],
 Apply a
 .IR "left italic correction" :
-modify the spacing of the following glyph so that the spacing between
-that glyph and the preceding glyph is correct if the preceding glyph is
-a roman glyph.
+modify the spacing of the following glyph so that the distance between
+it and the preceding glyph is correct if the latter is of upright shape.
 .
 For example,
 if a roman left parenthesis is immediately followed by an
@@ -850,8 +848,8 @@ between them
 .\}
 avoids this problem.
 .
-Use this escape sequence whenever a roman glyph is immediately followed
-by an italic glyph without any intervening space.
+Use this escape sequence whenever an upright glyph is followed
+immediately by an oblique glyph without any intervening space.
 .
 .
 .TP