gbranden pushed a commit to branch master
in repository groff.
commit c3c026044325543aabe0ff8d9dab8646c8566815
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Aug 16 15:23:09 2024 -0500
[docs]: Fix inaccurate claim about `.t` register.
* doc/groff.texi.in (Page Location Traps): Correct erroneous claim; the
`.t` register does not interpolate the maximum representable integer
in a diversion when there is no pending diversion trap if the output
device does not have a vertical resolution of "1" ("ps" does; "utf8"
doesn't).
Problem introduced by me in commit 18697e757c, 22 November 2020. Thanks
to Dave Kemper for the discussion in Savannah #63587.
---
ChangeLog | 11 +++++++++++
doc/groff.texi.in | 4 ++--
man/groff.7.man | 11 +++++++++++
3 files changed, 24 insertions(+), 2 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 9959ac25a..3c065d2a0 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2024-08-16 G. Branden Robinson <[email protected]>
+
+ * doc/groff.texi.in (Page Location Traps): Correct erroneous
+ claim; the `.t` register does not interpolate the maximum
+ representable integer in a diversion when there is no pending
+ diversion trap if the output device does not have a vertical
+ resolution of "1" ("ps" does; "utf8" doesn't).
+
+ Problem introduced by me in commit 18697e757c, 22 November 2020.
+ Thanks to Dave Kemper for the discussion in Savannah #63587.
+
2024-08-16 G. Branden Robinson <[email protected]>
* src/roff/troff/number.cpp (is_valid_term): When reading an
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 208afe15f..93e2dd501 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -14901,10 +14901,10 @@ caused by the @code{bp} request are not shown in the
output.
@cindex distance to next vertical position trap register (@code{.t})
@cindex trap, distance to next vertical position, register (@code{.t})
The read-only register @code{.t} holds the distance to the next vertical
-position trap. If there are no traps between the current position and
+position trap. If no such traps exist between the drawing position and
the bottom of the page, it contains the distance to the page bottom.
Within a diversion, in the absence of a diversion trap, this distance is
-the largest representable integer in basic units---effectively infinite.
+the maximum possible vertical position supported by the output device.
@endDefreg
@Defreq {ch, name [@Var{dist}]}
diff --git a/man/groff.7.man b/man/groff.7.man
index 1d3b759dd..ef834539a 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -6495,6 +6495,17 @@ see
and
.request .ch .
.
+If no such traps exist between the drawing position
+and the bottom of the page,
+.I @g@troff
+interpolates the distance to the page bottom.
+.
+Within a diversion,
+in the absence of a diversion trap,
+this distance is
+the maximum possible vertical position supported by the output device.
+.
+.
.TP
.REG .T
An output device was explicitly selected (Boolean-valued);
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
