gbranden pushed a commit to branch master
in repository groff.
commit 5b8c9e94d28145cb72bf49944ac48f245ce06fa1
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Jan 3 07:31:22 2026 -0600
[doc,man]: Migrate `\A` to "input" term.
Also break input lines consistently between Texinfo and man pages.
Add material to groff(7) regarding what constitutes a valid identifier.
Continues the long process of fixing Savannah #65976.
---
doc/groff.texi.in | 24 +++++++++++++++++-------
man/groff.7.man | 15 +++++++++++++--
man/groff_diff.7.man | 4 ++--
3 files changed, 32 insertions(+), 11 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 326504d96..3181e5ef0 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -7356,13 +7356,23 @@ and
@samp{.]}
as bibliographic reference delimiters.
-@Defesc {\\A, @code{'}, anything, @code{'}}
-Interpolate@tie{}1 if @var{anything} is a valid identifier, and@tie{}0
-otherwise. The delimiter need not be a neutral apostrophe; see
-@ref{Delimiters}. Because GNU @command{troff} ignores any input
-character with an invalid code when reading it, invalid identifiers are
-empty or contain spaces, tabs, newlines, or escape sequences that
-interpolate something other than a sequence of ordinary characters.
+@Defesc {\\A, @code{'}, input, @code{'}}
+Interpolate@tie{}1 if
+@var{input}
+is a valid identifier,
+and@tie{}0 otherwise.
+The delimiter need not be a neutral apostrophe; see
+@ref{Delimiters}.
+Because GNU
+@command{troff} @c GNU
+ignores any input character with an invalid code when reading it,
+invalid identifiers are empty or contain
+spaces,
+tabs,
+newlines,
+or
+escape sequences
+that interpolate something other than a sequence of ordinary characters.
You can employ @code{\A} to validate a macro argument before using it to
construct another escape sequence or identifier.
diff --git a/man/groff.7.man b/man/groff.7.man
index 1b5ba6095..bdf50fcd0 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5869,12 +5869,23 @@ and
Interpolate a leader in copy mode.
.
.TP
-.ESCq A anything
+.ESCq A input
Interpolate 1 if
-.I anything
+.I input
is a valid identifier,
and\~0 otherwise.
.
+Because GNU
+.I troff \" GNU
+ignores any input character with an invalid code when reading it,
+invalid identifiers are empty or contain
+spaces,
+tabs,
+newlines,
+or
+escape sequences
+that interpolate something other than a sequence of ordinary characters.
+.
.TP
.ESCq b string
Build bracket:
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 9df1a59e1..6325c6c01 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -849,9 +849,9 @@ and section \[lq]Compatibility Mode\[rq] below.
.
.\"TP 10n \" "\D'E h v'" + 2n + hand-tuned for PDF
.TP 14n \" "\A'anything'" + 2n
-.BI \[rs]A\[aq] anything \[aq]
+.BI \[rs]A\[aq] input \[aq]
Interpolate 1 if
-.I anything
+.I input
is a valid identifier,
and\~0 otherwise.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
