gbranden pushed a commit to branch master
in repository groff.
commit 799f343087fbf8a9803dd518cdc1ac9ca2421c09
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Jul 23 18:13:44 2026 -0500
[doc,man]: Note cross-troff `rm`, `rr` difference.
Also, GNU troff does not warn on attempts to remove a nonexistent
register.
---
doc/groff.texi.in | 36 ++++++++++++++++++++++++++++++------
man/groff_diff.7.man | 18 ++++++++++++++++++
2 files changed, 48 insertions(+), 6 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 50b08bac6..506765b74 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -9636,15 +9636,15 @@ under aliases created with
if any.
The formatter performs no operation on a nonexistent
@var{reg}.
-
If
@var{reg}
-is undefined,
-the formatter ignores the request.@footnote{GNU
+is an invalid identifier,
+GNU
@command{troff} @c GNU
-emits a warning in category
-@samp{reg}.
-@xref{Warnings}.}
+diagnoses an error,
+but processes any subsequent valid
+@var{reg}
+arguments.
This request is incorrectly documented in the @acronym{AT&T}
@code{troff} manual as accepting only one argument.
@@ -16956,6 +16956,15 @@ treats subsequent interpolations or calls of
as if it had never been defined.
The formatter performs no operation on a nonexistent
@var{name}.
+If
+@var{name}
+is an invalid identifier,
+GNU
+@command{troff} @c GNU
+diagnoses an error,
+but processes any subsequent valid
+@var{name}
+arguments.
This request is incorrectly documented in the @acronym{AT&T}
@command{troff} @c AT&T
@@ -24178,6 +24187,21 @@ spaces or tabs between the ordinary control character
and a
or macro name that would normally end a macro definition
prevent it from doing so.
+Solaris and Heirloom Doctools
+@code{troff}s' @c Solaris, Heirloom
+@code{rm}
+and
+@code{rr}
+requests halt argument processing
+upon encountering an invalid identifier.
+Those of
+GNU,
+DWB,
+and Plan@tie{}9 from User Space
+@code{troff}s @c GNU, DWB, Plan 9
+do not;
+they remove any subsequent valid arguments.
+
GNU
@command{troff} @c GNU
regards a failed attempt to select a different font
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index c33a0641d..82af2772c 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -6820,6 +6820,24 @@ prevent it from doing so.
.
.
.P
+Solaris and Heirloom Doctools
+.IR troff s' \" Solaris, Heirloom
+.B rm
+and
+.B rr
+requests halt argument processing
+upon encountering an invalid identifier.
+.
+Those of
+GNU,
+DWB,
+and Plan\~9 from User Space
+.IR troff s \" GNU, DWB, Plan 9
+do not;
+they remove any subsequent valid arguments.
+.
+.
+.P
GNU
.I troff \" GNU
regards a failed attempt to select a different font
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
