gbranden pushed a commit to branch master
in repository groff.
commit 6268d43cbbd696cb6bcaa6a966c295fd7843bc89
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Sun Jul 27 18:11:34 2025 -0500
doc/*,man/*: Keep kicking type size discussion.
* Organize the new concepts we're firing at the user so that they cohere
better. I hope.
* It's more accurate to say that "groff" (the system), not just the
output driver, rounds a requested type size to the nearest supported
size. The formatter, too, is and must be aware of this, or its
computations of glyph widths would be incorrect.
* Favor active voice over passive.
---
doc/groff.texi.in | 7 ++++---
man/groff.7.man | 21 ++++++++++-----------
man/groff_diff.7.man | 28 ++++++++++++++--------------
3 files changed, 28 insertions(+), 28 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 16dd5b2fa..df527c5c1 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -13318,7 +13318,7 @@ by the read-only string-valued register
@code{.sr}.
For example,
-if a type size of 10.95@tie{}points is requested,
+if a document requests a type size of 10.95@tie{}points,
and the nearest size permitted by a
@code{sizes}
request
@@ -13330,7 +13330,8 @@ directives in the device's
@file{DESC}
file)
is 11@tie{}points,
-the output driver uses the latter value.
+@code{groff}
+uses the latter value.
@endDefreg
@c END Keep (roughly) parallel with subsection "Fractional type sizes
@c and new scaling units" of groff_diff(7).
@@ -19657,7 +19658,7 @@ and a
@slanted{compatibility restore}
token at its end,
enabling compatibility mode during its interpolation.@footnote{Recall
-@ref{Strings}.}}
+@ref{Strings}.}
Thus they work as expected
even if the interpolation context disables compatibility mode.
@c END Keep in sync with groff_diff(7), subsection "Altered requests".
diff --git a/man/groff.7.man b/man/groff.7.man
index 7a29cbe2f..4d130542c 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -4692,21 +4692,20 @@ positions.
.
.TPx
.REQ .sizes "s1 s2 \f[R].\|.\|.\&\f[] sn \f[R][\f[B]0\f[]]"
-Set available type sizes similarly to the
-.B sizes
-directive in a
-.I DESC
-file.
-.
-Each
+Set available type sizes to the list of values or ranges;
+each
.IR s i
is interpreted in units of scaled points (\c
-.scaleindicator z ).
+.scaleindicator s ).
.
-A leading neutral double quote is stripped from
+GNU
+.I troff \" GNU
+strips a leading neutral double quote from
.IR s1 ;
-the arguments are
-read in copy mode and continue to the end of the input line.
+it reads
+each
+.IR s i
+in copy mode.
.
.TPx
.REQ .so file
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 603081cdb..5375e0659 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -392,20 +392,17 @@ and otherwise defaults to\~1;
see
.MR groff_font @MAN5EXT@ .
.
-Requests and escape sequences in GNU
+GNU
.I troff \" GNU
-interpret arguments that accept a numerical expression
-indicating a type size default to units of typographical points,
-.\" Legacy forms of the `\s` escape sequence don't accept numerical
-.\" expressions--only integers.
-which the program multiplies by
-.I sizescale
-and converts to an integer.
-.
-The scaling unit
-.B z
-explicitly specifies these typographical points of potentially
+also defines the
+.I "typographical point,"
+scaling unit
+.BR z ,
+which explicitly specifies type size of potentially
non-integral measure.
+The program multiplies typographical points by
+.I sizescale
+and converts the value to an integer.
.
Arguments GNU
.I troff \" GNU
@@ -415,6 +412,8 @@ units by default comprise those to the escape sequences
.B \[rs]H
and
.BR \[rs]s ,
+.\" Legacy forms of the `\s` escape sequence don't accept numerical
+.\" expressions--only integers.
to the request
.BR ps ,
the third argument to the
@@ -507,7 +506,7 @@ the requested ones are properties of an environment.
.
.P
For example,
-if a type size of 10.95\~points is requested,
+if a document requests a type size of 10.95\~points,
and the nearest size permitted by a
.B sizes
request
@@ -519,7 +518,8 @@ directives in the device's
.I DESC
file)
is 11\~points,
-the output driver uses the latter value.
+.I groff
+uses the latter value.
.\" END Keep (roughly) parallel with groff.texi node "Using Fractional
.\" Type Sizes".
.
_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
