gbranden pushed a commit to branch master
in repository groff.
commit db260c1e8bd8d7d0e74aaf94e5f5fab02a0e3f78
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Mar 27 05:03:24 2025 -0500
[doc,man]: Recast italic correction discussions.
---
doc/groff.texi.in | 84 ++++++++++++++++++++++++++++++++++------------------
man/groff_diff.7.man | 37 ++++++++++++++---------
man/groff_font.5.man | 23 ++++++++------
3 files changed, 92 insertions(+), 52 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 697f782e3..87bd4772b 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -12006,17 +12006,24 @@ space between them may require adjustment.
@Defesc {\\/, , , }
@cindex italic correction (@code{\/})
@cindex correction, italic (@code{\/})
-@cindex correction between oblique and upright glyph (@code{\/}, @code{\,})
-@cindex roman glyph, correction after italic glyph (@code{\/})
-@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 followed immediately by a roman right
-parenthesis, then in many fonts the top right portion of
-the@tie{}@samp{f} overlaps the top of the right parenthesis, which is
-ugly. Use this escape sequence whenever an oblique glyph is immediately
-followed by an upright glyph without any intervening space.
+@cindex corrections between slanted and upright glyphs (@code{\/}, @code{\,})
+@cindex roman glyph, correction after slanted glyph (@code{\/})
+@cindex upright glyph, correction after slanted 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 followed immediately
+by a roman right parenthesis,
+then in many fonts the top right portion of the@tie{}@samp{f}
+overlaps the top of the right parenthesis,
+which is ugly.
+Use
+@code{\/}
+whenever a slanted glyph
+is followed immediately by an upright glyph
+without any intervening space.
@endDefesc
@Defesc {\\@comma{}, , , }
@@ -12025,14 +12032,21 @@ followed by an upright glyph without any intervening
space.
@cindex correction between upright and oblique glyph (@code{\/}, @code{\,})
@cindex roman glyph, correction before italic glyph (@code{\,})
@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 an upright glyph is followed
-immediately by an oblique glyph without any intervening space.
+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
+@code{\,}
+whenever an upright glyph
+is followed immediately by a slanted glyph
+without any intervening space.
@endDefesc
@c XXX: Can we move this node earlier in the text? Should it come
@@ -20016,8 +20030,8 @@ the glyph is sought in any mounted fonts that bear this
property.
Often,
such fonts are
@dfn{unstyled},
-having no heavy (bold) or oblique
-(slanted or italic)
+having no heavy (bold) or slanted
+(italic or oblique)
variants.
@end table
@@ -20139,14 +20153,26 @@ rather than a negative height. The @var{depth}
subfield gives the depth
of the glyph, that is, the distance below the baseline to which the
glyph extends (downward 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} 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.
+depth.
+Italic corrections apply when upright and slanted
+(italic or oblique)
+styles are typeset adjacently.
+The
+@var{italic-correction}
+is the amount of space
+that should be added after a slanted glyph
+to be followed immediately by an upright glyph.
+The
+@var{left-italic-correction}
+is the amount of space
+that should be added before a slanted glyph
+to be preceded immediately by an upright glyph.
+The
+@var{subscript-correction}
+is the amount of space
+that should be added after a slanted glyph
+to be followed by a subscript;
+it should be less than the italic correction.
For fonts used with typesetters, the @var{type} field gives a featural
description of the glyph: it is a bit mask recording whether the glyph
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index f37ab9e72..82aaa6792 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1389,14 +1389,15 @@ as arguments.
.B \[rs]\|/
Apply an
.IR "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.
+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 followed immediately by a roman right
-parenthesis,
-then in many fonts the top right portion of the\~\[lq]f\^\[rq] overlaps
-the top of the right parenthesis,
+if an italic\~\[lq]f\^\[rq] is followed immediately
+by a roman right parenthesis,
+then in many fonts the top right portion of the\~\[lq]f\^\[rq]
+overlaps the top of the right parenthesis,
.if t producing \f[I]f\f[R]),
which is ugly.
.
@@ -1411,20 +1412,25 @@ between them
.\}
avoids this problem.
.
-Use this escape sequence whenever an oblique glyph is immediately
-followed by an upright glyph without any intervening space.
+Use
+.B \[rs]\^/
+whenever a slanted 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 distance between
-it and the preceding glyph is correct if the latter is of upright shape.
+if a roman left parenthesis is immediately followed by an
+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\~\[lq]f\^\[rq],
+if a roman left parenthesis is immediately followed
+by an italic\~\[lq]f\^\[rq],
then in many fonts the bottom left portion of the\~\[lq]f\^\[rq]
overlaps the bottom of the left parenthesis,
.if t producing \f[R](\f[I]f\f[R],
@@ -1441,8 +1447,11 @@ between them
.\}
avoids this problem.
.
-Use this escape sequence whenever an upright glyph is followed
-immediately by an oblique glyph without any intervening space.
+Use
+@code{\,}
+whenever an upright glyph
+is followed immediately by a slanted glyph
+without any intervening space.
.
.
.TP
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index a0f581119..8d2af6826 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -682,8 +682,8 @@ the glyph is sought in any mounted fonts that bear this
property.
Often,
such fonts are
.IR unstyled ,
-having no heavy (bold) or oblique
-(slanted or italic)
+having no heavy (bold) or slanted
+(italic or oblique)
variants.
.
.
@@ -863,23 +863,28 @@ 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.
+Italic corrections apply when upright and slanted
+(italic or oblique)
+styles are typeset adjacently.
.
The
.I italic-correction
-is the amount of space that should be added after an oblique glyph to be
-followed immediately by an upright glyph.
+is the amount of space
+that should be added after a slanted glyph
+to be followed immediately by an upright glyph.
.
The
.I left-italic-correction
-is the amount of space that should be added before an oblique glyph to
-be preceded immediately by an upright glyph.
+is the amount of space
+that should be added before a slanted glyph
+to be preceded immediately by an upright glyph.
.
The
.I
subscript-correction
-is the amount of space that should be added after an oblique glyph to be
-followed by a subscript;
+is the amount of space
+that should be added after a slanted glyph
+to be followed by a subscript;
it should be less than the italic correction.
.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
