[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 06/10: [docs]: Clarify italic correction material.
From: |
G. Branden Robinson |
Subject: |
[groff] 06/10: [docs]: Clarify italic correction material. |
Date: |
Sat, 25 Sep 2021 10:36:07 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 9ec882babacc440fb43226ca31705201e4a834a4
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Sep 25 22:13:11 2021 +1000
[docs]: Clarify italic correction material.
* Make it clear that a subscript correction is intended to be applied
only to oblique glyphs.
* Lose the description of glyph lists in charset subsections as
"ordered"; it is, but it's a mere partial ordering and that only if
you use aliases.
* Tighten wording.
* Fix missing thin space between end of ellipsis and comma in man page.
* Improve sync between Texinfo nodes and groff_font(5).
---
doc/groff.texi | 29 ++++++++++++++---------------
man/groff_font.5.man | 39 ++++++++++++++++++---------------------
2 files changed, 32 insertions(+), 36 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index eb1c0fb..48bd9bb 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -17882,7 +17882,7 @@ The default font family is @var{fam}.
@item fonts @var{n} @var{F1} @r{@dots{}} @var{Fn}
@kindex fonts
-Fonts @var{F1} @dots{} @var{Fn} are mounted in the font positions
+Fonts @var{F1}, @dots{}, @var{Fn} are mounted at font positions
@var{m}+1, @dots{}, @var{m}+@var{n} where @var{m} is the number of
@code{styles} (see below). This directive may extend over more than one
line. A font name of@tie{}@code{0} causes no font to be mounted at the
@@ -18134,10 +18134,10 @@ is optional.
@kindex charset
The directive @code{charset} starts the character set
subsection.@footnote{For typesetter devices, this keyword is misnamed
-since it starts an ordered list of glyphs, not characters.} The
-@code{charset} line is followed by a sequence of lines, each with
-information about one glyph. A line comprises a number of fields
-separated by spaces or tabs. The format is as follows.
+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}]
@@ -18211,14 +18211,13 @@ glyph, that is, the distance below the baseline to
which the glyph
extends (downwards is positive); if a glyph does not extend below the
baseline, it should be given a zero depth, rather than a negative depth.
Italic corrections are relevant to glyphs in italic or oblique styles.
-The @var{italic-correction} subfield gives the amount of space that
-should be added after the glyph when it is to be immediately followed by
-a glyph from an upright style. The @var{left-italic-correction}
-subfield gives the amount of space that should be added before the glyph
-when it is to be immediately preceded by a glyph from an upright style.
-The @var{subscript-correction} gives the amount of space that should be
-added after a glyph before adding a subscript. This should be less than
-the italic correction.
+The @var{italic-correction} is the amount of space that should be added
+after an oblique glyph to be followed immediately by an upright glyph.
+The @var{left-italic-correction} is the amount of space that should be
+added before an oblique glyph to be preceded immediately by an 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.
The @var{type} field gives a featural description of the glyph.
@@ -18230,8 +18229,8 @@ means the glyph has a descender (for example, @samp{p});
means the glyph has an ascender, (for example, @samp{b}); and
@item 3
-means the glyph has both an ascender and a descender (for example, this
-is true of parentheses in some fonts).
+means the glyph has both an ascender and a descender (for example,
+parentheses in some fonts).
@end table
The @var{code} field gives a numeric identifier that the postprocessor
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 6e58a6a..1ee2312 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -128,8 +128,8 @@ The default font family is
.BI fonts\~ "n F1"\~\c
.RI .\|.\|.\&\~ Fn
Fonts
-.IR F1 ", \|.\|.\|., " Fn
-are mounted in the font positions
+.IR F1 ", \|.\|.\|.\|, " Fn
+are mounted at font positions
.IR m "\|+\|1, \|.\|.\|., " m \|+\| n
where
.I m
@@ -653,20 +653,17 @@ is optional.
.P
The directive
.B charset
-starts the charset subsection.
+starts the character set subsection.
.
(For typesetter devices,
-this keyword is a misnomer since it starts an ordered list of glyphs,
+this keyword is a misnomer since it starts a list of glyphs,
not characters.)
.
-The
-.B charset
-line is followed by a sequence of lines,
-each with information about one glyph.
-.
-A line comprises a number of fields separated by spaces or tabs.
+It precedes a series of glyph descriptions,
+one per line.
.
-The format is as follows.
+Each such glyph description comprises a set of fields separated by
+spaces or tabs and organized as follows.
.
.
.IP
@@ -776,20 +773,20 @@ Italic corrections are relevant to glyphs in italic or
oblique styles.
.
The
.I italic-correction
-subfield gives the amount of space that should be added after the glyph
-when it is to be followed immediately by a glyph from an upright style.
+is the amount of space that should be added after an oblique glyph to be
+followed immediately by an upright glyph.
.
The
.I left-italic-correction
-subfield gives the amount of space that should be added before the glyph
-when it is to be preceded immediately by a glyph from an upright style.
+is the amount of space that should be added before an oblique glyph to
+be preceded immediately by an upright glyph.
.
The
-.I subscript-correction
-gives the amount of space that should be added after a glyph before
-adding a subscript.
-.
-This should be less than the italic correction.
+.I
+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.
.
.
.P
@@ -817,7 +814,7 @@ and
3
means the glyph has both an ascender and a descender
(for example,
-this is true of parentheses in some fonts).
+parentheses in some fonts).
.
.
.P
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 06/10: [docs]: Clarify italic correction material.,
G. Branden Robinson <=