gbranden pushed a commit to branch master
in repository groff.
commit 66b865cf198184af7a43e819a55ca96f4777c806
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat May 9 08:59:14 2026 -0500
[doc,man]: Document new `ti` request behavior.
NEWS: Add item.
---
NEWS | 5 +++++
doc/groff.texi.in | 7 +++++++
man/groff.7.man | 4 ++++
man/groff_diff.7.man | 10 ++++++++++
4 files changed, 26 insertions(+)
diff --git a/NEWS b/NEWS
index 5e5398cfd..ca79f8520 100644
--- a/NEWS
+++ b/NEWS
@@ -50,6 +50,11 @@ troff
the request (and issues a warning in category "range"), leaving the
operand (first request argument) unchanged instead of emptying it.
+* When the `ti` request is given no arguments, the formatter now
+ cancels any pending temporary indentation. (Formerly, it did nothing
+ in any troff, except, in GNU troff, issuing a warning in category
+ "missing".)
+
* The `phw` request now accepts arguments. Each is interpreted as a
possible hyphenation word (ignoring hyphens in the input), looked
up in the hyphenation exception list for the hyphenation language,
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 503172777..18ef05b4e 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -12038,6 +12038,13 @@ reports the indentation that applies to the pending
output line.
The temporary indentation is associated
with the environment.@footnote{@xref{Environments}.}
+If
+@var{amount}
+is omitted,
+GNU
+@command{troff} @c GNU
+cancels any pending temporary indentation.
+
@cindex first-line indentation, of paragraph
@cindex indentation, first line, of paragraph
@cindex hanging paragraph
diff --git a/man/groff.7.man b/man/groff.7.man
index fa717485f..4cd4f9efc 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5515,6 +5515,10 @@ Set tab repetition character
(default: none).
.
.TPx
+.REQ .ti
+Cancel any pending temporary indentation.
+.
+.TPx
.REQ .ti \[+-]N
Temporarily indent next output line
(default scaling unit\~\c
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 822ecb387..96d753fd1 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -2257,6 +2257,16 @@ then at
and so on.
.
.
+.TP
+.B .ti
+In
+GNU
+.IR troff , \" GNU
+invoking the
+.B ti
+request without an argument cancels any pending temporary indentation.
+.
+.
.\" ====================================================================
.SS "New requests"
.\" ====================================================================
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
