[groff] 03/25: [docs]: (Numeric expressions) Fix style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 588c0b4a9fa72a15ebec7cba32a649e25d9116b8
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Mar 28 23:35:32 2022 +1100

    [docs]: (Numeric expressions) Fix style nits.
    
    * Apply Oxford comma.
    * Clarify sense of positive direction in motion expressions.
    * Be more specific when discussing what it is that tab stops "reckon".
    * Add synchronization comment brackets for this material to groff(7).
---
 doc/groff.texi  | 9 ++++-----
 man/groff.7.man | 8 ++++++--
 2 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 9ac9c77a..689a1d13 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -5770,7 +5770,7 @@ man page for the @file{62bit.tmac} macro package.}
 Arithmetic infix operators perform a function on the numeric expressions
 to their left and right; they are @code{+} (addition), @code{-}
 (subtraction), @code{*} (multiplication), @code{/} (truncating
-division) and @code{%} (modulo).  Overflow and division by zero are
+division), and @code{%} (modulo).  Overflow and division by zero are
 errors and abort evaluation of a numeric expression.
 @cindex unary operators
 @cindex operators, unary
@@ -5929,8 +5929,8 @@ X=\n[X] Y=\n[Y] Z=\n[Z]
 For many requests and escape sequences that cause motion on the page,
 the unary operators @code{+} and @code{-} work differently when leading
 a numeric expression.  They then indicate a motion relative to the
-current drawing position:@: down in vertical contexts, right in
-horizontal ones.
+current drawing position:@: positive is down in vertical contexts, right
+in horizontal ones.
 
 @cindex @code{bp} request, using @code{+} and@tie{}@code{-} with
 @cindex @code{in} request, using @code{+} and@tie{}@code{-} with
@@ -5965,8 +5965,7 @@ A leading @code{|} operator indicates a motion relative 
not to the
 current position but to a boundary.  For horizontal motions, the
 measurement specifies a distance relative to the drawing position
 corresponding to the beginning of the @emph{input} line.  By default,
-tab stops reckon measurements in this way.  Most escape sequences do
-not;
+tab stops reckon movements in this way.  Most escape sequences do not;
 @c XXX: Which ones do?
 @code{|} tells them to do so.
 
diff --git a/man/groff.7.man b/man/groff.7.man
index 6b9a1c88..e059b866 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -739,6 +739,8 @@ multiply by 65,536
 .SH "Numeric expressions"
 .\" ====================================================================
 .
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Numeric
+.\" expressions".
 A
 .I numeric expression
 is a syntactic structure,
@@ -977,7 +979,7 @@ and
 work differently when leading a numeric expression.
 .
 They then indicate a motion relative to the current drawing position:
-down in vertical contexts,
+positive is down in vertical contexts,
 right in horizontal ones.
 .
 .
@@ -1020,7 +1022,7 @@ corresponding to the beginning of the
 line.
 .
 By default,
-tab stops reckon measurements in this way.
+tab stops reckon movements in this way.
 Most escape sequences do not;
 .\" XXX: Which ones do?
 .B |
@@ -1052,6 +1054,8 @@ 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}.
+.\" END Keep (roughly) parallel with groff.texi node "Numeric
+.\" expressions".
 .
 .
 .\" ====================================================================