gbranden pushed a commit to branch master
in repository groff.
commit 2ffef935c556441f6bd6205896039840c3926d12
Author: G. Branden Robinson <[email protected]>
AuthorDate: Tue Jun 3 06:12:39 2025 -0500
doc/*,man/*: Recast undefined identifier handling.
---
doc/groff.texi.in | 28 +++++++++++++++++++---------
man/groff.7.man | 24 ++++++++++++------------
2 files changed, 31 insertions(+), 21 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 8ce57e42a..127167c80 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -6854,15 +6854,25 @@ Expressions} for the @code{\B} escape sequence.
@cindex undefined identifiers
@cindex identifiers, undefined
-How GNU @code{troff} handles the interpretation of an undefined
-identifier depends on the context. There is no way to invoke an
-undefined request; such syntax is interpreted as a macro call instead.
-If the identifier is interpreted as a string, macro, or diversion, GNU
-@code{troff} emits a warning in category @samp{mac}, defines it as
-empty, and interpolates nothing. If the identifier is interpreted as a
-register, GNU @code{troff} emits a warning in category @samp{reg},
-initializes it to zero, and interpolates that value. @xref{Warnings},
-@ref{Interpolating Registers}, and @ref{Strings}.
+The formatter's handling of undefined identifiers is context-dependent.
+There is no way to invoke an undefined request;
+such syntax is interpreted as a macro call instead.
+If the identifier is interpreted as a string,
+macro,
+or diversion name,
+the formatter defines it as empty and interpolates nothing.@footnote{GNU
+@command{troff} @c GNU
+emits a warning in category
+@samp{mac}.
+@xref{Warnings}.}
+Similarly,
+if the identifier is interpreted as a register name,
+the formatter initializes it to zero
+and interpolates that value.@footnote{GNU
+@command{troff} @c GNU
+emits a warning in category
+@samp{reg}.
+@xref{Warnings}.}
Attempting to use an undefined
typeface,
special character or character class,
diff --git a/man/groff.7.man b/man/groff.7.man
index df8ed8840..fbf7574d8 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1438,29 +1438,29 @@ tests its argument for validity as an identifier.
.
.
.P
-How GNU
-.I troff \" GNU
-handles the interpretation of an undefined identifier depends on the
-context.
+The formatter's handling of undefined identifiers is context-dependent.
.
There is no way to invoke an undefined request;
such syntax is interpreted as a macro call instead.
.
If the identifier is interpreted as a string,
macro,
-or diversion,
-.I @g@troff
+or diversion name,
+the formatter defines it as empty and interpolates nothing.
+(GNU
+.I troff \" GNU
emits a warning in category
-.RB \[lq] mac \[rq],
-defines it as empty,
-and interpolates nothing.
+.RB \[lq] mac \[rq].
+See section \[lq]Warnings\[rq] of
+.MR @g@troff @MAN1EXT@ .)
.
-If the identifier is interpreted as a register,
+Similarly,
+if the identifier is interpreted as a register name,
+the formatter initializes it to zero
+and interpolates that value.
.I @g@troff
emits a warning in category
.RB \[lq] reg \[rq],
-initializes it to zero,
-and interpolates that value.
.
See section \[lq]Warnings\[rq] in
.MR @g@troff @MAN1EXT@ ,
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
