gbranden pushed a commit to branch master
in repository groff.
commit c4a0cdd17170d6d938a862a7d7c51c346cf45f25
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Apr 11 07:55:18 2025 -0500
[doc],groff_font(5): Tighten wording.
Also sync input line breaks between Texinfo and man page.
---
doc/groff.texi.in | 34 ++++++++++++++++++++++------------
man/groff_font.5.man | 18 +++++++++---------
2 files changed, 31 insertions(+), 21 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 731444ed7..f2859cd75 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -20093,7 +20093,7 @@ When the formatter configures a type size,
it scales the metrics linearly relative to that basis.
The unit width has no inherent relationship to the device resolution,
and the same division procedure applies to all font metrics.
-One observes that whatever unit might select for the unit width,
+Observe that whatever unit might one select for the unit width,
the division operation implied by scaling cancels it out,
leaving a dimensionless quantity.
@@ -20306,31 +20306,41 @@ into the C language data type
as they are in @acronym{AT&T} device-independent
@code{troff}. @c AT&T
-The @var{width} subfield gives the width of the glyph. The @var{height}
-subfield gives the height of the glyph (upward is positive); if a glyph
-does not extend above the baseline, it should be given a zero height,
-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.
+The
+@var{width}
+subfield gives the width of the glyph.
+The
+@var{height}
+subfield gives the height of the glyph
+(upward is positive);
+if a glyph does not extend above the baseline,
+give it a zero height,
+not 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,
+give it a zero depth,
+not a negative 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 add 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 add 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 add after a slanted glyph
to be followed by a subscript;
it should be less than the italic correction.
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 6b567cc24..51eddb03a 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -553,7 +553,7 @@ it scales the metrics linearly relative to that basis.
The unit width has no inherent relationship to the device resolution,
and the same division procedure applies to all font metrics.
.
-One observes that whatever unit might select for the unit width,
+Observe that whatever unit might one select for the unit width,
the division operation implied by scaling cancels it out,
leaving a dimensionless quantity.
.
@@ -857,18 +857,18 @@ The
subfield gives the height of the glyph
(upward is positive);
if a glyph does not extend above the baseline,
-it should be given a zero height,
-rather than a negative height.
+give it a zero height,
+not a negative height.
.
The
.I depth
-subfield gives the depth of the glyph,
+subfield gives the depth of the glyph\[em]\c
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.
+give it a zero depth,
+not a negative depth.
.
Italic corrections apply when upright and slanted
(italic or oblique)
@@ -877,20 +877,20 @@ styles are typeset adjacently.
The
.I italic-correction
is the amount of space
-that should be added after a slanted glyph
+to add 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 a slanted glyph
+to add 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 a slanted glyph
+to add 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
