gbranden pushed a commit to branch master
in repository groff.
commit a2750b3a8021e29c9276b95577b5f19b2983b545
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Fri Mar 7 15:41:42 2025 -0600
[doc,man]: Clarify and correct font measurements.
Sync language and line breaks between our Texinfo manual and
groff_font(5) man page.
---
doc/groff.texi.in | 37 +++++++++++++++++++++++++++----------
man/groff_font.5.man | 17 +++++++++++++----
2 files changed, 40 insertions(+), 14 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index ef330e1e1..f79714f72 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -19970,13 +19970,24 @@ The form of the @var{metrics} field is as follows.
@end display
@noindent
-There must not be any spaces, tabs, or newlines between these
-@dfn{subfields} (which have been split here into two lines only for
-better legibility). The subfields are in basic units expressed as
-decimal integers. Unspecified subfields default to@tie{}@code{0}.
-Since there is no associated binary format, these values are not
-required to fit into the C language data type @samp{char} as they are in
-@acronym{AT&T} device-independent @code{troff}.
+Spaces,
+tabs,
+and newlines are prohibited
+between these
+@dfn{subfields},
+which are expressed as decimal integers
+(and have been split here into two lines only for better legibility).
+The unit of measure is that established by the
+@code{unitwidth}
+directive and scaled to the type size.
+Unspecified subfields default
+to@tie{}@code{0}.
+Since there is no associated binary format,
+these values are not required to fit
+into the C language data type
+@samp{char}
+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
@@ -20084,9 +20095,15 @@ of lines formatted as follows.
@endExample
@noindent
-The foregoing means that when glyph @var{g1} is typeset immediately
-before @var{g2}, the space between them should be increased
-by@tie{}@var{n}. Most kerning pairs should have a negative value
+The foregoing means that when glyph
+@var{g1}
+is typeset immediately before @var{g2},
+the space between them should be increased
+by@tie{}@var{n}.
+The unit of measure is that established by the
+@code{unitwidth}
+directive and scaled to the type size.
+Most kerning pairs should have a negative value
for@tie{}@var{n}.
@c END Keep parallel with groff_font(5).
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 37e27aa19..a0f581119 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -818,18 +818,23 @@ it may be broken here for readability).
.
.
.P
-There must not be any spaces,
+Spaces,
tabs,
-or newlines between these
+and newlines are prohibited
+between these
.I subfields,
+which are expressed as decimal integers.
.
-which are in basic units expressed as decimal integers.
+The unit of measure is that established by the
+.B \%unitwidth
+directive and scaled to the type size.
.
Unspecified subfields default
.RB to\~ 0 .
.
Since there is no associated binary format,
-these values are not required to fit into the C language data type
+these values are not required to fit
+into the C language data type
.B char
as they are in AT&T device-independent
.IR troff . \" AT&T
@@ -1056,6 +1061,10 @@ is typeset immediately before
the space between them should be increased
.RI by\~ n .
.
+The unit of measure is that established by the
+.B \%unitwidth
+directive and scaled to the type size.
+.
Most kerning pairs should have a negative value
.RI for\~ n .
.\" END Keep parallel with groff.texi node "Device and Font Description
_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
