[groff] 31/40: groff_font(5),groff.texi: Fix correctness nit.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 74f1ccccc78be94c9799fd1786f77f3861fe350a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Feb 6 02:23:25 2022 +1100

    groff_font(5),groff.texi: Fix correctness nit.
    
    ...and style nits.
    
    * man/groff_font.5.man:
      - "f" is a metasyntactic variable for the font name as groff knows its
        description on the file system, not whatever name the font may have
        for itself (whether a file name or as part of some internal data
        structure); recast accordingly.
      - The static library that handles opening device and font description
        files is libgroff, not libdriver.
      - Tighten wording to cut down on orphan words.
      - Apply a poor man's keep.
    
    * doc/groff.texi (Device and Font Description Files): Sync with above.
---
 doc/groff.texi       | 34 +++++++++++++++++-----------------
 man/groff_font.5.man | 30 +++++++++++++++---------------
 2 files changed, 32 insertions(+), 32 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index f3c41b11..5a608f93 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -18161,20 +18161,20 @@ extensions of those used by @acronym{AT&T} 
device-independent
 @code{groff} lacks a binary format; all files are text
 files.@footnote{Plan@tie{}9 @code{troff} has also abandoned the binary
 format.}  The device and font description files for a device @var{name}
-are stored in a @file{dev@var{name}} directory.  The device
-description file is called @file{DESC}, and, for each font@tie{}@var{f}
-supported by the device, a font description file is
-called@tie{}@file{@var{f}}, where @var{f}@tie{}is usually an
-abbreviation of a font's name and/or style.  For example, the @code{ps}
-(PostScript) device has @code{groff} font description files for Times
-roman (@file{TR}) and Zapf Chancery Medium italic (@file{ZCMI}), among
-many others, while the @code{utf8} device (for terminal emulators) has
-only font descriptions for the roman, italic, bold, and bold-italic
-styles (@file{R}, @file{I}, @file{B}, and @file{BI}, respectively).
+are stored in a @file{dev@var{name}} directory.  The device description
+file is called @file{DESC}, and, for each font supported by the device,
+a font description file is called@tie{}@file{@var{f}}, where
+@var{f}@tie{}is usually an abbreviation of a font's name and/or style.
+For example, the @code{ps} (PostScript) device has @code{groff} font
+description files for Times roman (@file{TR}) and Zapf Chancery Medium
+italic (@file{ZCMI}), among many others, while the @code{utf8} device
+(for terminal emulators) has only font descriptions for the roman,
+italic, bold, and bold-italic styles (@file{R}, @file{I}, @file{B}, and
+@file{BI}, respectively).
 
 Device and font description files are read both by the formatter, GNU
 @code{troff}, and by output drivers.  The programs delegate these files'
-interpretation to an internal library, @file{libdriver}, ensuring their
+processing to an internal library, @file{libgroff}, ensuring their
 consistent interpretation.
 
 @menu
@@ -18223,7 +18223,7 @@ corresponding position.
 @cindex horizontal resolution
 @cindex resolution, horizontal
 The horizontal resolution is @var{n}@tie{}basic units.  All horizontal
-quantities are rounded to multiples of this value.
+quantities are rounded to multiples of@tie{}@var{n}.
 
 @item image_generator @var{program}
 @kindex image_generator
@@ -18357,7 +18357,7 @@ uses this directive.
 @cindex vertical resolution
 @cindex resolution, vertical
 The vertical resolution is @var{n}@tie{}basic units.  All vertical
-quantities are rounded to multiples of this value.
+quantities are rounded to multiples of@tie{}@var{n}.
 
 @item charset
 @kindex charset
@@ -18375,8 +18375,8 @@ GNU @code{troff} recognizes but ignores the directives 
@code{spare1},
 
 The @code{res}, @code{unitwidth}, @code{fonts}, and @code{sizes} lines
 are mandatory.  Directives not listed above are ignored by GNU
-@code{troff} but may be used by postprocessors to obtain arbitrary
-information about a device in the @file{DESC} file.
+@code{troff} but may be used by postprocessors to obtain further
+information about the device.
 
 @c ---------------------------------------------------------------------
 
@@ -18457,8 +18457,8 @@ property.
 @end table
 
 Other directives in this section are ignored by GNU @code{troff}, but
-may be used by postprocessors to obtain arbitrary information about the
-font in the file.
+may be used by postprocessors to obtain further information about the
+font.
 
 The second section contains one or two subsections.  These can appear in
 either order; the first one encountered commences the second section.
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 4e3fca66..423d62fa 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -56,11 +56,9 @@ directory.
 The device description file is called
 .IR DESC ,
 and,
-for each
-.RI font\~ f
-supported by the device,
+for each font supported by the device,
 a font description file is
-.RI called\~\[lq] f \[rq],
+.RI called\~ f,
 where
 .IR f \~is
 usually an abbreviation of a font's name and/or style.
@@ -97,9 +95,9 @@ Device and font description files are read both by the 
formatter,
 .IR \%@g@troff ,
 and by output drivers.
 .
-The programs delegate these files' interpretation to an internal
+The programs delegate these files' processing to an internal
 library,
-.IR libdriver ,
+.IR libgroff ,
 ensuring their consistent interpretation.
 .
 .
@@ -174,7 +172,8 @@ The horizontal resolution is
 .IR n \~basic
 units.
 .
-All horizontal quantities are rounded to multiples of this value.
+All horizontal quantities are rounded to multiples
+.RI of\~ n.
 .
 .
 .TP
@@ -473,12 +472,13 @@ The vertical resolution is
 .IR n \~basic
 units.
 .
-All vertical quantities are rounded to multiples of this value.
+All vertical quantities are rounded to multiples
+.RI of\~ n.
 .
 .
 .TP
 .B charset
-This line and everything following it in the file are ignored.
+This directive and the rest of the file are ignored.
 .
 It is recognized for compatibility with other
 .I troff \" generic
@@ -509,10 +509,8 @@ lines are mandatory.
 .
 Directives not listed above are ignored by
 .I \%@g@troff
-but may be used by postprocessors to obtain arbitrary information about
-the device described in the
-.I DESC
-file.
+but may be used by postprocessors to obtain further information about
+the device.
 .
 .
 .\" ====================================================================
@@ -666,8 +664,8 @@ it is sought in any mounted fonts that bear this property.
 .P
 Other directives in this section are ignored by
 .IR \%@g@troff ,
-but may be used by postprocessors to obtain arbitrary information about
-the font described in the file.
+but may be used by postprocessors to obtain further information about
+the font.
 .
 .
 .P
@@ -773,6 +771,8 @@ a font can thus customize the widths of these spaces.
 .\" Latin character, is a predefined groff escape sequence.
 .
 .
+.br
+.ne 4v \" Keep next paragraph together with (possibly 2-line) synopsis.
 .P
 The form of the
 .I metrics