[groff] 13/26: [docs]: Update description of `sizes` request.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 7eebe71904f0c77bba9bcce497eca5875de4a4c0
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Nov 13 18:57:28 2021 +1100

    [docs]: Update description of `sizes` request.
---
 doc/groff.texi       |  8 ++++----
 man/groff.7.man      |  9 +++++++--
 man/groff_diff.7.man | 17 +++++++----------
 3 files changed, 18 insertions(+), 16 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 5a48020..40ef73b 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -11004,10 +11004,10 @@ a single character as an argument) to change the font 
on the fly:
 .mc \s[20]x\s[0]
 @endExample
 
-@Defreq {sizes, s1 s2 @dots{} sn [0]}
-Some devices may only have certain permissible sizes, in which case
-@code{gtroff} rounds to the nearest permissible size.  The @file{DESC}
-file specifies which sizes are permissible for the device.
+@Defreq {sizes, s1 s2 @dots{} sn [@t{0}]}
+Some devices may permit only certain type sizes, in which case GNU
+@code{troff} rounds to the nearest permissible size.  The @file{DESC}
+file normally specifies which type sizes are allowed by the device.
 
 Use the @code{sizes} request to change the permissible sizes for the
 output device.  Arguments are in scaled points; the @code{sizescale}
diff --git a/man/groff.7.man b/man/groff.7.man
index 182b568..273eac4 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2947,12 +2947,17 @@ positions.
 .TPx
 .REQ .sizes "s1 s2 \fR\&.\|.\|.\&\fP s\fRn\~\c
 [\f[CB]0\f[]]
-Set available font sizes similar to the
+Set available type sizes similarly to the
 .B sizes
-command in a
+directive in a
 .I DESC
 file.
 .
+Each
+.IR s i
+is interpreted in units of scaled points (\c
+.scaleindicator z ).
+.
 .
 .TPx
 .REQ .so file
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 2c4993a..dda325a 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -2955,17 +2955,12 @@ is missing, arguments are shifted by\~1.
 .
 Shifting by negative amounts is currently undefined.
 .
+.
 .TP
 .BI .sizes\~ "s1 s2\~"\c
 .RI .\|.\|.\~ sn\~\c
 .RB [ 0 ]
-This request is similar to the
-.B sizes
-command of a
-.I DESC
-file.
-.
-It sets the available font sizes for the current font to
+Set the available type sizes to
 .IR s1 ,
 .IR s2 ,
 \&.\|.\|.\&
@@ -2977,11 +2972,13 @@ The list of sizes can be terminated by an
 .
 Each
 .I si
-can also be a range of sizes
+can also be a range
 .IR m \(en n .
 .
-Contrary to the font file command, the list can't extend over more
-than a single line.
+In contrast to the device description file directive of the same name
+(see
+.MR groff_font @MAN5EXT@ ),
+the argument list can't extend over more than one line.
 .
 .
 .TP