[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 06/09: [ms]: Fix documentation style nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 06/09: [ms]: Fix documentation style nits. |
Date: |
Mon, 14 Jun 2021 14:32:28 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 54fa95ee2d14774cc6e5639b7e844d4c7ae4d40f
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jun 15 02:46:41 2021 +1000
[ms]: Fix documentation style nits.
* Recast for correctness of implicit algebraic sign.
* Drop parenthesis around phrase so sentence parses grammatically
without it. (If either choice of including or omitting a
parenthesized phrase breaks the grammar of your sentence, you need
something stronger than parentheses.)
---
doc/groff.texi | 6 +++---
doc/ms.ms | 10 ++++------
tmac/groff_ms.7.man | 6 +++---
3 files changed, 10 insertions(+), 12 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index aad9fd9..70f343d 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -3210,8 +3210,8 @@ adjustment mechanism is in effect.
If the @code{GROWPS} register is set to a value greater than the
@var{level} argument to @code{NH} or @code{SH}, the point size of
a heading produced by these macros increases by @code{PSINCR} units over
-the size specified by @code{PS} multiplied by the difference between
-@var{level} and @code{GROWPS}. The value stored in @code{PSINCR} is
+the size specified by @code{PS} multiplied by the difference of
+@code{GROWPS} and @var{level}. The value stored in @code{PSINCR} is
interpreted in @code{groff} basic units; the @code{p} scaling indicator
should be employed when assigning a value specified in points. For
example, the sequence
@@ -3671,7 +3671,7 @@ it. Text in the box is automatically placed in a
diversion (keep).
These macros cause line breaks; if you need to box a word or phrase
within a line, see the @code{BX} macro in @ref{Highlighting in ms}. Box
lines are drawn as close as possible to the text they enclose so that
-they are usable within paragraphs. If you wish to box one (or more)
+they are usable within paragraphs. If you wish to box one or more
paragraphs, you may improve the appearance by calling @code{B1} after
the first paragraphing macro, and by adding a small amount of vertical
space before calling @code{B2}.
diff --git a/doc/ms.ms b/doc/ms.ms
index ae4f49d..6a189e6 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -1028,10 +1028,10 @@ the point size of a heading produced by these macros
increases by
.CW \[rs]n[PSINCR]
units over
.CW \[rs]n[PS]
-multiplied by the difference between
-.I level
+multiplied by the difference of
+.CW \[rs]n[GROWPS]
and
-.CW \[rs]n[GROWPS] .
+.I level .
.
.
For example,
@@ -1785,9 +1785,7 @@ macro in section \[lq]Highlighting\[rq] above.
Box lines are drawn as close as possible to the text they enclose so
that they are usable within paragraphs.
.
-If you wish to box one
-(or more)
-paragraphs,
+If you wish to box one or more paragraphs,
you may improve the appearance by calling
.CW .B1
after the first paragraphing macro,
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 7aaffa3..333fa7c 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -760,10 +760,10 @@ the point size of a heading produced by these macros
increases by
.B \[rs]n[PSINCR]
units over
.B \[rs]n[PS]
-multiplied by the difference between
-.I level
+multiplied by the difference of
+.B \[rs]n[GROWPS]
and
-.BR \[rs]n[GROWPS] .
+.IR level .
.
.
.PP
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 06/09: [ms]: Fix documentation style nits.,
G. Branden Robinson <=