gbranden pushed a commit to branch master
in repository groff.
commit 7907ba888c35b23c8fa3b27109c825a1cb64bd08
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Jul 5 19:28:44 2026 -0500
[doc,man]: Reform terminology.
Speak of an "output comparison expression", not an "output comparison
operator". There is no "operator" per se. (I've contemplated adding
one: there is room in the grammar to use `=` for this purpose at the
start of a conditional expression, because `=` cannot _start_ a
_numeric_ expression.)
* doc/groff.texi.in:
* man/groff.7.man:
* man/groff_diff.7.man: Do it.
Also:
* Parallelize wording better between our Texinfo manual and man pages.
* doc/groff.texi.in: Add context index entries.
* man/groff.7.man: Use `I` macro more efficiently.
---
doc/groff.texi.in | 12 ++++++------
man/groff.7.man | 4 ++--
man/groff_diff.7.man | 4 ++--
3 files changed, 10 insertions(+), 10 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 22c013ae3..f9714e2fd 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -6787,7 +6787,7 @@ have been observed in
@code{roff}
documents,
particularly in macro packages employing them as delimiters
-with the output comparison operator
+with an output comparison expression
to try to avoid collisions
with the content of arbitrary user-supplied parameters
(@pxref{Operators in Conditionals}).
@@ -17056,20 +17056,20 @@ and GNU
@command{troff} @c GNU
may provide additional operators in the future.}
-@cindex output comparison operator
+@cindex output comparison expression
+@cindex comparison expression, output
+@cindex expression, output comparison
@table @code
@item @code{'}@var{xxx}@code{'}@var{yyy}@code{'}
This
-@dfn{output comparison operator}
+@dfn{output comparison expression}
interpolates a true value
if formatting the comparands
@var{xxx}
and
@var{yyy}
produces the same output commands.
-The delimiter need not be a neutral apostrophe:
-the output comparison operator accepts the same delimiters as most
-escape sequences;
+Other delimiters can be used in place of the neutral apostrophes;
recall @ref{Delimiters}.
@command{troff} @c generic
formats
diff --git a/man/groff.7.man b/man/groff.7.man
index f97bd290c..ef0a3fadf 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -401,7 +401,7 @@ have been observed in
.I roff
documents,
particularly in macro packages employing them as delimiters
-with the output comparison operator
+with an output comparison expression
to try to avoid collisions with the content
of arbitrary user-supplied parameters
(see subsection \[lq]Conditional expressions\[rq] below).
@@ -2675,7 +2675,7 @@ the formatter performs an
.
Shown first in the table above,
the
-.I output comparison operator
+.I "output comparison expression"
interpolates a true value if formatting its comparands
.I s1
and
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index e78372aae..c33a0641d 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1875,7 +1875,7 @@ This feature has two applications.
.
.
.IP
-Surround operands to the output comparison operator
+Surround operands to an output comparison expression
with
.B \[rs]?\&
to compare them
@@ -5878,7 +5878,7 @@ keeps track of the nesting depth of escape sequence
interpolations and other uses of delimiters,
as in the
.B tl
-request and the output comparison operator
+request and output comparison expressions
(that is,
input like
.B \[aq]foo\[aq]bar\[aq]
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
