gbranden pushed a commit to branch master
in repository groff.
commit 6b42eda67484b37de3ba01d6c4afc5bc7f345d28
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Apr 18 21:33:57 2026 -0500
[doc,man]: Document AT&T vs. GNU `sv` behavior.
---
doc/groff.texi.in | 19 +++++++++++++++++++
man/groff_diff.7.man | 13 +++++++++++++
2 files changed, 32 insertions(+)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 4d7e2df5d..8cd8296d8 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -23031,6 +23031,25 @@ GNU
rounds down the values of minimum inter-word and additional
inter-sentence space each to the nearest multiple of@tie{}12.
+@cindex @code{sv} request, incompatibilities with @acronym{AT&T} @code{troff}
+In AT&T
+@command{troff}, @c AT&T
+the
+@code{sv}
+request springs a page location trap
+if it is nearer to the drawing position
+than the amount of vertical space requested;
+GNU
+@command{troff} @c GNU
+saves the space but does not spring the trap.
+To simulate AT&T behavior,
+consider the following.
+
+@Example
+.sv 3i \" or however much space you need
+.if \n(.g .ne 3i
+@endExample
+
@cindex @code{bd} request, incompatibilities with @acronym{AT&T} @code{troff}
@cindex @code{cs} request, incompatibilities with @acronym{AT&T} @code{troff}
@cindex @code{tr} request, incompatibilities with @acronym{AT&T} @code{troff}
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 144c4c308..f8ec02898 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -7108,6 +7108,19 @@ rounds down the values of minimum inter-word and
additional
inter-sentence space each to the nearest multiple of\~12.
.
.
+.P
+In AT&T
+.I troff \" AT&T
+the
+.B sv
+request springs a page location trap
+if it is nearer to the drawing position
+than the amount of vertical space requested;
+GNU
+.I troff \" GNU
+saves the space but does not spring the trap.
+.
+.
.\" TODO: A lot of this discussion should move to "Using Symbols" and
.\" "GNU troff Internals" (or whatever those sections get named once
.\" ported to this man page).
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
