gbranden pushed a commit to branch master
in repository groff.
commit df75310bfd9f75706c3f0122a18b027a178245a9
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Dec 7 00:45:20 2025 -0600
[doc,man]: Revise defn of "page location trap".
Don't use the term "undiverted" [output] to refer to the contents of the
top-level diversion. The former usage is too confusing.
---
doc/groff.texi.in | 14 +++++++++++---
man/groff.7.man | 8 +++-----
2 files changed, 14 insertions(+), 8 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 4ac45da3e..d8566d6dc 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -16650,9 +16650,17 @@ Implicit Page Trap}.
@cindex page location traps
@cindex traps, page location
-A @dfn{page location trap} is a vertical position trap that applies to
-the page; that is, to undiverted output. Many can be present; manage
-them with the @code{wh} and @code{ch} requests.
+A
+@dfn{page location trap}
+is a vertical position trap that applies to the page;
+that is,
+to the top-level diversion.
+Many can be present;
+manage them with the
+@code{wh}
+and
+@code{ch}
+requests.
@Defreq {wh, dist [@Var{name}]}
Plant macro @var{name} as page location trap at @var{dist}. The default
diff --git a/man/groff.7.man b/man/groff.7.man
index 35ef51890..fdba6a018 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -8559,14 +8559,12 @@ with its corresponding amount of motion
.
A
.I "page location trap"
-is a vertical position trap that applies to
-the page;
+is a vertical position trap that applies to the page;
that is,
-to undiverted output.
+to the top-level diversion.
.
Many can be present;
-manage them with
-the
+manage them with the
.B wh
and
.B ch
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
