diff options
author | G. Branden Robinson <g.branden.robinson@gmail.com> | 2020-04-06 17:45:53 +1000 |
---|---|---|
committer | G. Branden Robinson <g.branden.robinson@gmail.com> | 2020-04-06 17:45:53 +1000 |
commit | ede696a10fdbbdcbd9092c206d32c92e7e8067d7 (patch) | |
tree | 8c1dc165fbb774d3476d7e0e43cc9103e922e866 | |
parent | 0b9aaca060117edfc65af8264fa791ed7e851633 (diff) | |
download | groff-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.texi | 12 |
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} |