[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 13/26: [docs]: Update description of `sizes` request.
From: |
G. Branden Robinson |
Subject: |
[groff] 13/26: [docs]: Update description of `sizes` request. |
Date: |
Sun, 14 Nov 2021 22:04:27 -0500 (EST) |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 13/26: [docs]: Update description of `sizes` request.,
G. Branden Robinson <=