[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 13/33: [docs]: Align presentations of `\A`.
From: |
G. Branden Robinson |
Subject: |
[groff] 13/33: [docs]: Align presentations of `\A`. |
Date: |
Sun, 16 Oct 2022 15:52:17 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit b966b3ff5676e460ebb9a4ead1d7db50f9af8470
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Oct 11 09:04:16 2022 -0500
[docs]: Align presentations of `\A`.
---
doc/groff.texi | 12 ++++++------
man/groff.7.man | 8 +-------
man/groff_diff.7.man | 25 +++++++++++--------------
3 files changed, 18 insertions(+), 27 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index f20411539..96a9cd978 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -6400,12 +6400,12 @@ characters @samp{[} or @samp{]}, you foreclose use of
the @code{grefer}
preprocessor, which recognizes @samp{.[} and @samp{.]} as bibliographic
reference delimiters.
-@Defesc {\\A, @code{'}, ident, @code{'}}
-Interpolate@tie{}1 if @var{ident} is a valid identifier in GNU
-@code{troff}, and@tie{}0 otherwise. The delimiter need not be a neutral
-apostrophe; see @ref{Delimiters}. Because invalid input characters are
-removed (see above), invalid identifiers are empty or contain spaces,
-tabs, or newlines.
+@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 invalid input characters are removed (see
+above), invalid identifiers are empty or contain spaces, tabs, or
+newlines.
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 7cd0fb84a..0be14ad91 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -4494,17 +4494,11 @@ and
In copy mode,
interpolate leader character.
.
-.
.TP
.ESCq A anything
Interpolate 1 if
.I anything
-is an acceptable identifier for a string,
-macro,
-diversion,
-register,
-environment,
-or font,
+is a valid identifier,
and\~0 otherwise.
.
.TP
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index a9b9ce9b8..9e87c8243 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -510,23 +510,20 @@ and then by symbol roughly in Unicode code point order.
.
.TP
.BI \[rs]A\[aq] anything \[aq]
-This expands to
-.B 1
-or\~\c
-.BR 0 ,
-depending on whether
+Interpolate 1 if
.I anything
-is or is not acceptable as the name of a string, macro, diversion,
-register, environment, font, or color.
+is a valid identifier,
+and\~0 otherwise.
.
-It returns\~\c
-.B 0
-if
-.I anything
-is empty.
+Because invalid input characters are
+removed, invalid identifiers are empty or contain spaces,
+tabs,
+or newlines.
.
-This is useful if you want to look up user input in some sort of
-associative table.
+You can employ
+.B \[rs]A
+to validate a macro argument before using it to construct another escape
+sequence or identifier.
.
.TP
.BI \[rs]B\[aq] anything \[aq]
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 13/33: [docs]: Align presentations of `\A`.,
G. Branden Robinson <=