[groff] 14/30: [doc,man]: Clarify `\s` behavior.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 00228141947cbbb86c1f867e9b63fddc1b8d699c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Dec 21 17:55:24 2024 -0600

    [doc,man]: Clarify `\s` behavior.
---
 doc/groff.texi.in | 12 ++++++++++--
 man/groff.7.man   | 25 +++++++++++++++++++++----
 2 files changed, 31 insertions(+), 6 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 88a584426..81100bfa8 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -12160,8 +12160,10 @@ The @code{\s} escape sequence supports a variety of 
syntax forms.
 @item \s@var{n}
 Set the type size to @var{n}@tie{}scaled points.  @var{n}@tie{}must be a
 single digit.@footnote{In compatibility mode only, a non-zero @var{n}
-must be in the range 4--39.  @xref{Compatibility Mode}.}  If
-@var{n}@tie{}is 0, restore the previous size.
+must be in the range 4--39.  @xref{Compatibility Mode}.}
+If @var{n}@tie{}is
+@samp{0},
+restore the previous size.
 
 @item \s+@var{n}
 @itemx \s-@var{n}
@@ -12171,6 +12173,9 @@ Increase or decrease the type size by 
@var{n}@tie{}scaled points.
 @item \s(@var{nn}
 Set the type size to @var{nn}@tie{}scaled points.  @var{nn} must be
 exactly two digits.
+If @var{n}@tie{}is
+@samp{00},
+restore the previous size.
 
 @item \s+(@var{nn}
 @itemx \s-(@var{nn}
@@ -12408,6 +12413,9 @@ or @code{sizescale} directives in the device's 
@file{DESC} file) is 11
 points, the output driver uses the latter value.
 @endDefreg
 
+@cindex changing type sizes (@code{ps}, @code{\s})
+@cindex type sizes, changing (@code{ps}, @code{\s})
+@cindex point sizes, changing (@code{ps}, @code{\s})
 The @code{\s} escape sequence offers the following syntax forms that
 work with fractional type sizes and accept scaling units.  You may of
 course give them integral arguments.  The delimited forms need not use
diff --git a/man/groff.7.man b/man/groff.7.man
index 325ed98f4..3f6d56ef9 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5612,8 +5612,12 @@ Set/increase/decrease the type size to/by
 scaled points.
 .
 .I N
-must be a single digit;
-0 restores the previous type size.
+must be a single digit.
+.
+If
+.IR n \~is
+\[lq]0\[rq],
+restore the previous size.
 .
 (In compatibility mode only,
 a non-zero
@@ -5636,7 +5640,13 @@ scaled points;
 .I N
 is a two-digit number \[>=]1.
 .
-As
+If
+.IR n \~is
+\[lq]00\[rq],
+restore the previous size.
+.
+Otherwise,
+as
 .request .ps
 request.
 .
@@ -5653,7 +5663,14 @@ Set/increase/decrease the type size to/by
 .I N
 scaled points.
 .
-As
+If
+.IR n \~is
+\[lq]0\[rq]
+(with any number of leading zeroes),
+restore the previous size.
+.
+Otherwise,
+as
 .request .ps
 request.
 .