summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorG. Branden Robinson <g.branden.robinson@gmail.com>2020-04-06 17:45:53 +1000
committerG. Branden Robinson <g.branden.robinson@gmail.com>2020-04-06 17:45:53 +1000
commitede696a10fdbbdcbd9092c206d32c92e7e8067d7 (patch)
tree8c1dc165fbb774d3476d7e0e43cc9103e922e866
parent0b9aaca060117edfc65af8264fa791ed7e851633 (diff)
downloadgroff-git-ede696a10fdbbdcbd9092c206d32c92e7e8067d7.tar.gz
doc/groff.texi: Tweak \s discussion.
Recast language regarding acceptable inputs to \sN in compatibility mode. Regarding migration away from \sN, stop implying that \s(NN and \s[N] are the only options. Swap paragraph order to put the cross-reference to fractional-point-size-supporting escapes immediately the previous and before the detail about whether a point-size escape constitutes an input token.
-rw-r--r--doc/groff.texi12
1 files changed, 6 insertions, 6 deletions
diff --git a/doc/groff.texi b/doc/groff.texi
index 63812489b..be84531ec 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -10054,9 +10054,9 @@ and the text begins. Any of the following forms are valid:
Set the point size to @var{n}@tie{}points. @var{n}@tie{}must be a
single digit.
-In compatibility mode only, @var{n}@tie{}must be@tie{}0 or in the range
+In compatibility mode only, a non-zero @var{n}@tie{}must be in the range
4 to@tie{}39. Legacy documents relying upon this quirk of parsing
-should be migrated to the \s(@var{nn} or \s[@var{n}] forms.
+should be migrated to another @code{\s} form.
@item \s+@var{n}
@itemx \s-@var{n}
@@ -10075,6 +10075,10 @@ Increase or decrease the point size by @var{nn}@tie{}points. @var{nn}
must be exactly two digits.
@end table
+@xref{Fractional Type Sizes}, for additional syntactical forms of
+the @code{\s} escape (which accept integers as well as fractions).
+@endDefreq
+
Note that @code{\s} doesn't produce an input token in @code{gtroff}. As
a consequence, it can be used in requests like @code{mc} (which expects
a single character as an argument) to change the font on the fly:
@@ -10083,10 +10087,6 @@ a single character as an argument) to change the font on the fly:
.mc \s[20]x\s[0]
@endExample
-@xref{Fractional Type Sizes}, for yet another syntactical form of using
-the @code{\s} escape.
-@endDefreq
-
@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}