gbranden pushed a commit to branch master
in repository groff.
commit b105a28042f3896ad8d9c2591bca06e2b034c1d5
Author: G. Branden Robinson <[email protected]>
AuthorDate: Tue Jun 3 06:18:32 2025 -0500
doc/*,man/*: Recast "call of undef macro" stuff.
Favor active voice over passive.
---
doc/groff.texi.in | 15 +++++++++++----
man/groff.7.man | 15 ++++++++++-----
2 files changed, 21 insertions(+), 9 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 127167c80..cd628a01d 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -7140,10 +7140,17 @@ definitions (or any input lines) with blank lines.
@cindex macro arguments
@cindex arguments to macros
-If a macro of the desired name does not exist when called, it is
-created, assigned an empty definition, and a warning in category
-@samp{mac} is emitted. Calling an undefined macro @emph{does} end a
-macro definition naming it as its end macro (@pxref{Writing Macros}).
+If a macro of the desired name does not exist when called,
+the formatter creates it
+and assigns it an empty definition.@footnote{GNU
+@command{troff} @c GNU
+emits a warning in category
+@samp{mac}.
+@xref{Warnings}.}
+Calling an undefined macro
+@emph{does}
+end a macro definition naming it as its end macro
+(@pxref{Writing Macros}).
@cindex spaces, in a macro argument
To embed spaces @emph{within} a macro argument, enclose the argument in
diff --git a/man/groff.7.man b/man/groff.7.man
index fbf7574d8..52de04962 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1620,11 +1620,16 @@ authors use them to indent the source of documents or
macro files.
.
.\" BEGIN Keep (roughly) parallel with groff.texi node "Calling Macros".
If a macro of the desired name does not exist when called,
-it is created,
-assigned an empty definition,
-and a warning in category
-.RB \[lq] mac \[rq]
-is emitted.
+the formatter creates it
+and assigns it an empty definition.
+.
+(GNU
+.I troff \" GNU
+emits a warning in category
+.RB \[lq] mac \[rq].
+.
+See section \[lq]Warnings\[rq] in
+.MR @g@troff @MAN1EXT@ .)
.
Calling an undefined macro
.I does
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
