gbranden pushed a commit to branch master
in repository groff.
commit 2a635bff259c6dda6b0b97b43d6b10d52c1d5c92
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri May 1 03:29:49 2026 -0500
[doc,man]: Revise, resync `vs` request desc.
* Parallelize wording with other recently revised request descriptions.
* Adjust poor man's keep.
* Break Texinfo input lines in convenient places for roffing and
diffing.
---
doc/groff.texi.in | 36 ++++++++++++++++++++++++++----------
man/groff.7.man | 7 +++++--
2 files changed, 31 insertions(+), 12 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index c92ac77c7..b152bc577 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -15065,18 +15065,34 @@ type size (such as @samp{12000}), or a range of sizes
(such as
@cindex changing vertical line spacing (@code{vs})
@cindex vertical line spacing, changing (@code{vs})
@cindex vertical line spacing register (@code{.v})
-Set the vertical spacing to, or alter it by, @var{space}. The default
-scaling unit is @samp{p}. If @code{vs} is invoked without an argument,
-the vertical spacing is reset to the previous value before the last call
-to @code{vs}.
+Set the vertical spacing to,
+or alter it by,
+@var{space}.
+The default scaling unit is
+@samp{p}.
+If
+@var{space}
+is omitted,
+the formatter resets the vertical spacing
+to its previous value,
+or the default if there is none.
@cindex @code{.V} register, and @code{vs}
-GNU @code{troff} emits a warning in category @samp{range} if @var{space}
-is negative; the vertical spacing is then set to the smallest possible
-positive value, the vertical motion quantum (as found in the @code{.V}
-register).
+If
+@var{space}
+is negative,
+the formatter sets
+the vertical spacing to the smallest possible positive value,
+the vertical motion quantum
+(as found in the
+@code{.V}
+register).@footnote{GNU
+@command{troff} @c GNU
+emits a warning in category @samp{range}.
+@xref{Warnings}.} @c omit footnote from man page
@w{@samp{.vs 0}}
-isn't saved in a diversion since it doesn't result in a vertical motion.
+isn't saved in a diversion since it doesn't result
+in a vertical motion.@footnote{@xref{Diversions}.}
You must explicitly issue this request
before interpolating the diversion if you desire its effect.
@@ -15085,7 +15101,7 @@ The read-only register
interpolates the vertical spacing.
@endDefreq
-@need 200
+@need 500
@cindex vertical line spacing, effective value
@noindent
When a break occurs, GNU @code{troff} performs the following procedure.
diff --git a/man/groff.7.man b/man/groff.7.man
index 093376a59..8f69aaafc 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5582,11 +5582,14 @@ Enable or disable vertical position traps per Boolean
expression
.
.TPx
.REQ .vs
-Change to previous vertical spacing.
+Reset the vertical spacing
+to its previous value,
+or the default if there is none.
.
.TPx
.REQ .vs \[+-]N
-Set vertical spacing to
+Set the vertical spacing to,
+or alter it by,
.I \[+-]N
(default scaling unit\~\c
.scaleindicator p ).
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
