gbranden pushed a commit to branch master in repository groff. commit f23b3f9a3aeea5f5158a268f2e85a71f1cd77a00 Author: G. Branden Robinson <g.branden.robin...@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. _______________________________________________ Groff-commit mailing list Groff-commit@gnu.org https://lists.gnu.org/mailman/listinfo/groff-commit