gbranden pushed a commit to branch master
in repository groff.

commit 66435920d5df76ca76eb06f6cad82fab1913baa3
Author: G. Branden Robinson <[email protected]>
AuthorDate: Mon Nov 3 00:10:58 2025 -0600

    [doc,man]: Improve numeric expression material.
    
    Clarify.  Favor active voice over passive.  Syncronize man page and
    Texinfo.
---
 doc/groff.texi.in | 15 +++++++++------
 man/groff.7.man   | 11 ++++++-----
 2 files changed, 15 insertions(+), 11 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 7a6d0046f..d80b79390 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -6920,9 +6920,11 @@ requests and escape sequences:@: @code{bp}, @code{in}, 
@code{ll},
 @code{lt}, @code{nm}, @code{nr}, @code{pl}, @code{pn}, @code{po},
 @code{ps}, @code{pvs}, @code{rt}, @code{ti}, @code{\H}, @code{\R}, and
 @code{\s}.  Here, leading plus and minus signs serve as incrementation
-and decrementation operators, respectively.  To negate an expression,
-subtract it from zero or include the unary minus in parentheses with its
-argument.  @xref{Setting Registers}, for examples.
+and decrementation operators, respectively.
+To negate an expression in these contexts,
+subtract it from zero
+or include the unary minus in parentheses with its argument.
+@xref{Setting Registers}, for examples.
 
 @opindex |
 @cindex @code{|}, and page motion
@@ -7019,9 +7021,10 @@ Register Formats}.
 
 @cindex space characters, in expressions
 @cindex expressions, and space characters
-Because spaces separate arguments to requests, spaces are not allowed in
-numeric expressions unless the (sub)expression containing them is
-surrounded by parentheses.  @xref{Invoking Requests}, and
+Because spaces separate arguments to requests,
+spaces are not allowed in numeric expressions
+unless parentheses surround the (sub)expression containing them.
+@xref{Invoking Requests}, and
 @ref{Conditionals and Loops}.
 
 @Example
diff --git a/man/groff.7.man b/man/groff.7.man
index b6ee85755..4b2ed4d1e 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1333,7 +1333,7 @@ leading plus and minus signs serve as incrementation and 
decrementation
 operators,
 respectively.
 .
-To negate an expression,
+To negate an expression in these contexts,
 subtract it from zero
 or include the unary minus in parentheses with its argument.
 .\" @xref{Setting Registers}, for examples.
@@ -1382,10 +1382,11 @@ this is the default.\" @xref{Assigning Register 
Formats}.
 .
 .
 .P
-Due to the way arguments are parsed,
-spaces are not allowed in numeric expressions unless the (sub)expression
-containing them is surrounded by parentheses.
-.\"@xref{Request and Macro Arguments}, and @ref{Conditionals and Loops}.
+Because spaces separate arguments to requests,
+spaces are not allowed in numeric expressions
+unless parentheses surround the (sub)expression containing them.
+.\"@xref{Invoking Requests}, and
+.\"@ref{Conditionals and Loops}.
 .\" END Keep (roughly) parallel with groff.texi node "Numeric
 .\" expressions".
 .

_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit

Reply via email to