[groff] 21/23: [ms]: Fix content and style nits in docs.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 4aa8ca95d91ce048f74ff84ad21b9d59a2c3b424
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Sep 15 23:28:52 2022 -0500

    [ms]: Fix content and style nits in docs.
    
    * Fix missing comma.
    * Drop extraneous word.
    * Drop reference to "implementation note", existing only in ms.ms.
    * Drop fragmentary "produces:" between example source and rendering.
    * Tighten wording.
---
 doc/groff.texi | 30 +++++++++++-------------------
 doc/ms.ms      |  4 ++--
 2 files changed, 13 insertions(+), 21 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index f42156439..18a9ec177 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -3062,9 +3062,9 @@ reaching an @code{AU}, @code{AB}, or heading or 
paragraphing macro call.
 @endDefmac
 
 @Defmac {DA, [@Var{x} @dots{}], ms}
-Typeset the current date, or any arguments @var{x} in the center footer,
-and, if @code{RP} is also called, left-aligned after other document
-description information on the cover page.
+Typeset the current date, or any arguments @var{x}, in the center
+footer, and, if @code{RP} is also called, left-aligned after other
+document description information on the cover page.
 @endDefmac
 
 @Defmac {ND, [@Var{x} @dots{}], ms}
@@ -3306,9 +3306,9 @@ the previous @code{NH} call---that is, you ``skip a 
depth'', as by
 warning on the standard error stream.
 
 Alternatively, you can give @code{NH} a first argument of@tie{}@code{S},
-followed by integers arguments to number the the heading depths
-explicitly.  Further automatic numbering, if used, resumes using the
-specified indices as their predecessors.
+followed by integers to number the heading depths explicitly.  Further
+automatic numbering, if used, resumes using the specified indices as
+their predecessors.
 @c Although undocumented in Tuthill's 4.2BSD ms.diffs paper...
 This feature is a Berkeley extension.
 @endDefmac
@@ -3467,10 +3467,9 @@ instead of bold.  This is a Tenth Edition Research Unix 
extension.
 
 @Defmac {BX, [@Var{text}], ms}
 Typeset @var{text} and draw a box around it.  On terminal devices,
-reverse video is used instead (see the implementation note below).
-If you want @var{text} to contain space, use unbreakable space or
-horizontal motion escape sequences (@code{\~}, @code{\SP}, @code{\^},
-@code{\|}, @code{\0} or @code{\h}).
+reverse video is used instead.  If you want @var{text} to contain space,
+use unbreakable space or horizontal motion escape sequences (@code{\~},
+@code{\SP}, @code{\^}, @code{\|}, @code{\0} or @code{\h}).
 @endDefmac
 
 @Defmac {UL, [@Var{text} [@Var{post}]], ms}
@@ -3575,8 +3574,6 @@ guns
 money
 @endCartoucheExample
 
-produces:
-
 @Example
 A bulleted list:
 
@@ -3602,8 +3599,6 @@ guns
 money
 @endCartoucheExample
 
-produces:
-
 @Example
 A numbered list:
 
@@ -3631,8 +3626,6 @@ Gotta pay for those
 lawyers and guns!
 @endCartoucheExample
 
-produces:
-
 @Example
 A glossary-style list:
 
@@ -4042,9 +4035,8 @@ Footnotes can be safely used within keeps and displays, 
but you should
 avoid using automatically numbered footnotes within floating keeps.  You
 can place a second @code{\**} interpolation between a @code{\**} and its
 corresponding @code{FS} call as long as each @code{FS} call occurs
-@emph{after} the corresponding @code{\**} and the occurrences of
-@code{FS} are in the same order as the corresponding occurrences of
-@code{\**}.
+@emph{after} the corresponding @code{\**} and occurrences of @code{FS}
+are in the same order as corresponding occurrences of @code{\**}.
 
 Footnote text is formatted as paragraphs are, using analogous
 parameters.  The registers @code{FI}, @code{FPD}, @code{FPS}, and
diff --git a/doc/ms.ms b/doc/ms.ms
index 2eb48dbdf..b0e61efce 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -2756,9 +2756,9 @@ call occurs
 .I after
 the corresponding
 .CW \[rs]**
-and the occurrences of
+and occurrences of
 .CW .FS
-are in the same order as the corresponding occurrences of
+are in the same order as corresponding occurrences of
 .CW \[rs]** .
 .
 .