gbranden pushed a commit to branch master
in repository groff.
commit 1b0fea04fbfd8fdfcfe3c017d0bb28982cb8dc38
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Wed Sep 4 03:30:42 2024 -0500
[doc,man]: Clarify and sync `ptr` description.
---
doc/groff.texi.in | 5 +++--
man/groff_diff.7.man | 6 +++++-
2 files changed, 8 insertions(+), 3 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 57e515b7a..c92888efc 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -17199,8 +17199,9 @@ error stream.
@cindex traps, page location, dumping (@code{ptr})
@cindex traps, page location, listing (@code{ptr})
Report the names and positions of all page location traps to the
-standard error stream. Empty slots in the list, where a trap has been
-planted but subsequently (re)moved, are printed as well.
+standard error stream. GNU @command{troff} reports empty slots in the
+list, where a trap had been planted but subsequently (re)moved, because
+they can affect the visibility of subsequently planted traps.
@c "because they can affect the priority of subsequently planted traps."
@c XXX Is that right? It's useful to print the empty slots, I think,
@c but a trap planted in an "empty" slot with .wh will become active.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 24e9f3e35..3d7becd37 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -3375,7 +3375,11 @@ except that input comes from the standard output stream
of
Report the names and vertical positions of all page location traps
to the standard error stream.
.
-Empty slots in the list are shown as well,
+GNU
+.I troff \" GNU
+reports empty slots in the list,
+where a trap had been planted
+but subsequently (re)moved,
because they can affect the visibility of subsequently planted traps.
.
.
_______________________________________________
Groff-commit mailing list
Groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
