[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 23/27: [docs]: Fix style nits (font description files).
From: |
G. Branden Robinson |
Subject: |
[groff] 23/27: [docs]: Fix style nits (font description files). |
Date: |
Mon, 28 Aug 2023 15:54:51 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit f96678bed3b46ba17f1ec11a83ebd25bbb5928cf
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Aug 28 11:27:59 2023 -0500
[docs]: Fix style nits (font description files).
---
doc/groff.texi | 33 ++++++++++++++++-----------------
man/groff_font.5.man | 10 +++++-----
2 files changed, 21 insertions(+), 22 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 45895a6ac..ded79644d 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -18445,9 +18445,9 @@ a font description file is called@tie{}@file{@var{f}},
where
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).
+(for terminals) 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'
@@ -18704,8 +18704,8 @@ throughout.
The name of the font is@tie{}@var{f}. @samp{DESC} is an invalid font
name. Simple integers are valid, but their use is
discouraged.@footnote{@code{groff} requests and escape sequences
-interpret non-negative font names as mounting positions instead.
-Further, a font named @samp{0} cannot be automatically mounted by the
+interpret non-negative integers as mounting positions instead. Further,
+a font named @samp{0} cannot be automatically mounted by the
@code{fonts} directive of a @file{DESC} file.}
@item spacewidth @var{n}
@@ -18751,11 +18751,10 @@ is optional.
@kindex charset
The directive @code{charset} starts the character set
-subsection.@footnote{For typesetter devices, this directive is misnamed
-since it starts a list of glyphs, not characters.} It precedes a series
-of glyph descriptions, one per line. Each such glyph description
-comprises a set of fields separated by spaces or tabs and organized as
-follows.
+subsection.@footnote{On typesetters, this directive is misnamed since it
+starts a list of glyphs, not characters.} It precedes a series of glyph
+descriptions, one per line. Each such glyph description comprises a set
+of fields separated by spaces or tabs and organized as follows.
@quotation
@var{name} @var{metrics} @var{type} @var{code} [@var{entity-name}]
@@ -18848,13 +18847,13 @@ upright glyph. The @var{subscript-correction} is the
amount of space
that should be added after an oblique glyph to be followed by a
subscript; it should be less than the italic correction.
-For fonts used with typesetting devices, the @var{type} field gives a
-featural description of the glyph: it is a bit mask recording whether
-the glyph is an ascender, descender, both, or neither. When a @code{\w}
-escape sequence is interpolated, these values are bitwise or-ed
-together for each glyph and stored in the @code{nr} register. In font
-descriptions for terminal devices, all glyphs might have a type of zero,
-regardless of their appearance.
+For fonts used with typesetters, the @var{type} field gives a featural
+description of the glyph: it is a bit mask recording whether the glyph
+is an ascender, descender, both, or neither. When a @code{\w} escape
+sequence is interpolated, these values are bitwise or-ed together for
+each glyph and stored in the @code{nr} register. In font descriptions
+for terminals, all glyphs might have a type of zero, regardless of their
+appearance.
@table @code
@item 0
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index b55fd648c..8888daf77 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -95,7 +95,7 @@ among many others,
while the
.B utf8
device
-(for terminal emulators)
+(for terminals)
has only font descriptions for the roman,
italic,
bold,
@@ -610,7 +610,7 @@ Simple integers are valid,
but their use is discouraged.
.
.RI ( groff
-requests and escape sequences interpret non-negative font names as
+requests and escape sequences interpret non-negative integers as
mounting positions instead.
.
Further,
@@ -712,7 +712,7 @@ The directive
.B charset
starts the character set subsection.
.
-(For typesetter devices,
+(On typesetters,
this directive is misnamed since it starts a list of glyphs,
not characters.)
.
@@ -872,7 +872,7 @@ it should be less than the italic correction.
.
.
.P
-For fonts used with typesetting devices,
+For fonts used with typesetters,
the
.I type
field gives a featural description of the glyph:
@@ -890,7 +890,7 @@ and stored in the
.B ct
register.
.
-In font descriptions for terminal devices,
+In font descriptions for terminals,
all glyphs might have a type of zero,
regardless of their appearance.
.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 23/27: [docs]: Fix style nits (font description files).,
G. Branden Robinson <=