[groff] 03/11: [docs]: Revise discussion of `sp` request.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 97bfc044c2f4e212724143a25c39b6257668f162
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue May 23 04:02:21 2023 -0500

    [docs]: Revise discussion of `sp` request.
---
 doc/groff.texi  | 19 ++++++++-----------
 man/groff.7.man | 20 ++++++++++++--------
 2 files changed, 20 insertions(+), 19 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index bf88cb8ff..80087d60f 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -8821,17 +8821,14 @@ The hyphenation space adjustment threshold is available 
in the
 @cindex spacing, manipulating
 
 @Defreq {sp, [@Var{distance}]}
-Break the line and place the next text baseline @var{distance} lower
-than it would otherwise be, or until springing a page location
-trap.@footnote{@xref{Page Location Traps}.}  If invoked with the
-no-break control character, @code{sp} moves the pending output line's
-text baseline by @var{distance}.  If @var{distance} would move the
-text baseline below the bottom of the page, the page is broken and
-any leftover distance discarded.  A negative distance moves the text
-baseline up the page, but will not reduce it below zero.  Inside a
-diversion, any @var{distance} argument is ignored.  The default scaling
-unit is @samp{v}.  If @var{distance} is not specified, @samp{1v} is
-assumed.
+Break and move the next text baseline down by @var{distance}, or until
+springing a page location trap.@footnote{@xref{Page Location Traps}.}
+If invoked with the no-break control character, @code{sp} moves the
+pending output line's text baseline by @var{distance}.  A negative
+@var{distance}, but will not reduce the position of the text baseline
+below zero.  Inside a diversion, any @var{distance} argument is ignored.
+The default scaling unit is @samp{v}.  If @var{distance} is not
+specified, @samp{1v} is assumed.
 
 @Example
 .pl 5v \" Set page length to 5 vees.
diff --git a/man/groff.7.man b/man/groff.7.man
index 7f1113909..ab5432a2e 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -4017,20 +4017,24 @@ does not exist.
 .
 .TPx
 .REQ .sp
-Break line and move drawing position down one vee.
+Break and move the next text baseline down by one vee,
+or until springing a page location trap.
 .
 .
 .TPx
-.REQ .sp \[+-]N
-Break line and move drawing position vertically by
-.I \[+-]N
+.REQ .sp dist
+Break and move the next text baseline down by
+.IR dist ,
+or until springing a page location trap
 (default scaling unit\~\c
 .scaleindicator v ).
 .
-Positive values are downwards.
+A negative
+.I dist
+will not reduce the position of the text baseline below zero.
 .
 Prefixing
-.I N
+.I dist
 with the
 .B \[or]
 operator moves to a position relative to the page top for positive
@@ -4040,9 +4044,9 @@ and the bottom if
 is negative;
 in all cases,
 one line height (vee) is added
-.RI to\~ N .
+.RI to\~ dist .
 .
-.I N
+.I dist
 is ignored inside a diversion.
 .
 .