gbranden pushed a commit to branch master
in repository groff.
commit 1d1f0962a54c0e15c72b2beaab8726f9084f3187
Author: G. Branden Robinson <[email protected]>
AuthorDate: Mon Jun 2 15:43:55 2025 -0500
doc/*,man/*: Recast description of `!` operator.
Favor active voice over passive.
Also synchronize wording between our Texinfo manual and groff(7).
---
doc/groff.texi.in | 28 +++++++++++++++++++---------
man/groff.7.man | 23 ++++++++++++++---------
2 files changed, 33 insertions(+), 18 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index f0073aeba..421fde3ee 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -6549,15 +6549,25 @@ within @code{if}, @code{ie}, and @code{while} requests.
@c This is worded to avoid implying that the operator doesn't apply
@c to conditional expressions in general, albeit without mentioning them
@c because they're out of scope.
-Furthermore, @code{!} is recognized only at the beginning of a numeric
-expression not contained by another numeric expression. In other words,
-it must be the ``outermost'' operator. Including it elsewhere in the
-expression produces a warning in the @samp{number} category
-(@pxref{Warnings}), and its expression evaluates false. This
-unfortunate limitation maintains compatibility with @acronym{AT&T}
-@code{troff}. Test a numeric expression for falsity within a complex
-expression by comparing it to a false value.@footnote{@xref{Conditionals
-and Loops}.}
+Furthermore,
+the formatter recognizes
+@code{!}
+only at the beginning of a numeric expression
+not contained by another numeric expression.
+In other words,
+@code{!} must be the ``outermost'' operator.
+Its presence elsewhere causes the expression
+to evaluate false.@footnote{GNU
+@command{troff} @c GNU
+emits a warning in category
+@samp{number}.
+@xref{Warnings}.}
+This unfortunate limitation maintains compatibility with @acronym{AT&T}
+@command{troff}.
+Test a numeric expression for falsity
+within a complex expression
+by comparing it
+to a false value.@footnote{@xref{Conditionals and Loops}.}
@Example
.nr X 1
diff --git a/man/groff.7.man b/man/groff.7.man
index 55db13e17..d9801859a 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1237,19 +1237,24 @@ requests.
.\" conditional expressions in general, albeit without mentioning them
.\" because they're out of scope.
Furthermore,
+the formatter recognizes
.B !\&
-is recognized only at the beginning of a numeric expression not
-contained by another numeric expression.
+only at the beginning of a numeric expression
+not contained by another numeric expression.
.
In other words,
-it must be the \[lq]outermost\[rq] operator.
+.B !\&
+must be the \[lq]outermost\[rq] operator.
.
-Including it elsewhere in the expression produces a warning in the
-.RB \%\[lq] number \[rq]
-category
-(see
-.MR @g@troff @MAN1EXT@ ),
-and its expression evaluates false.
+Its presence elsewhere causes the expression
+to evaluate false.
+.
+(GNU
+.I troff \" GNU
+emits a warning in category
+.RB \%\[lq] number \[rq].
+See section \[lq]Warnings\[rq] of
+.MR @g@troff @MAN1EXT@ .)
.
This unfortunate limitation maintains compatibility with AT&T
.IR troff .\" AT&T
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
