[groff] 17/26: [docs]: Clarify metrics in font description files.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit f23b3f9a3aeea5f5158a268f2e85a71f1cd77a00
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Nov 15 06:33:39 2021 +1100

    [docs]: Clarify metrics in font description files.
    
    * Document that the numbers in the metrics field are in basic units.
    * Break a long paragraph, starting a new one with the subfield
      definitions, after all the throat-clearing about the data format.
---
 doc/groff.texi       | 14 ++++++++------
 man/groff_font.5.man |  8 +++++---
 2 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 9da05b9..f20a892 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -18319,12 +18319,14 @@ The form of the @var{metrics} field is as follows.
 
 @noindent
 There must not be any spaces, tabs, or newlines between these subfields
-(it has been split here into two lines only for better legibility).
-Missing subfields are assumed to be@tie{}@code{0}.  The subfields are
-all decimal integers.  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}.  The
-@var{width} subfield gives the width of the glyph.  The @var{height}
+(it has been split here into two lines only for better legibility).  The
+subfields are in basic units expressed as decimal integers.  Missing
+subfields are assumed to be@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}.
+
+The @var{width} subfield gives the width of the glyph.  The @var{height}
 subfield gives the height of the glyph (upwards 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
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 97486ea..75259bc 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -7,7 +7,7 @@ groff_font \- GNU roff device and font description files
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2020 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2021 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff (GNU roff), which is a free software
 .\" project.
@@ -787,17 +787,19 @@ There must not be any spaces,
 tabs,
 or newlines between these subfields.
 .
+The subfields are in basic units expressed as decimal integers.
+.
 Missing subfields are assumed to
 .RB be\~ 0 .
 .
-The subfields are all decimal integers.
-.
 Since there is no associated binary format,
 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
 .
+.
+.P
 The
 .I width
 subfield gives the width of the glyph.