[groff] 06/09: [ms]: Fix documentation style nits.

[G. Branden Robinson]

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