[groff] 02/03: doc/groff.texi: Tweak \s discussion.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit ede696a10fdbbdcbd9092c206d32c92e7e8067d7
Author: G. Branden Robinson <address@hidden>
AuthorDate: Mon Apr 6 17:45:53 2020 +1000

    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.
---
 doc/groff.texi | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 6381248..be84531 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}