[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 03/25: [docs]: (Numeric expressions) Fix style nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 03/25: [docs]: (Numeric expressions) Fix style nits. |
Date: |
Mon, 28 Mar 2022 12:08:19 -0400 (EDT) |
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".
.
.
.\" ====================================================================
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 03/25: [docs]: (Numeric expressions) Fix style nits.,
G. Branden Robinson <=