From 94a3ae189df4a083bc1db84f408a0f25f169e969 Mon Sep 17 00:00:00 2001
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Date: Thu, 4 May 2023 16:49:11 -0500
Subject: [ms]: Align documentation.

Also slightly recast in places for better style.
---
 doc/groff.texi      | 12 ++++++------
 doc/ms.ms           |  7 ++++---
 tmac/groff_ms.7.man | 17 ++++++++++-------
 3 files changed, 20 insertions(+), 16 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 2db5aea19..99626b398 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -4477,9 +4477,9 @@ spread the dots.  The width of the page number field is stored in the
 The @code{groff} @file{ms} macros are an independent reimplementation,
 using no @acronym{AT&T} code.  Since they take advantage of the extended
 features of @code{groff}, they cannot be used with @acronym{AT&T}
-@code{troff}.  @code{groff} @file{ms} supports several features
-described above as Berkeley and Tenth Edition Research Unix extensions,
-and adds several of its own.
+@code{troff}.  @code{groff} @file{ms} supports features described above
+as Berkeley and Tenth Edition Research Unix extensions, and adds several
+of its own.
 
 @itemize @bullet
 @item
@@ -4495,7 +4495,7 @@ manual.@footnote{@cite{Typing Documents on the UNIX System: Using the
 
 @item
 The error-handling policy of @code{groff} @file{ms} is to detect and
-report errors, rather than silently to ignore them.
+report errors, rather than to ignore them silently.
 
 @item
 Tenth Edition @c possibly 9th
@@ -4813,8 +4813,8 @@ The following conventions are used for names of macros, strings, and
 registers.  External names available to documents that use the
 @code{groff} @file{ms} macros contain only uppercase letters and digits.
 
-Internally the macros are divided into modules.  The naming conventions
-are as follows.
+Internally, the macros are divided into modules.  Conventions for
+identifier names are as follows.
 
 @itemize @bullet
 @item
diff --git a/doc/ms.ms b/doc/ms.ms
index 03a13b46d..f58caae11 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -3914,7 +3914,7 @@ manual [Lesk 1978].
 The error-handling policy of
 .I groff ms
 is to detect and report errors,
-rather than silently to ignore them.
+rather than to ignore them silently.
 .
 .
 .PP
@@ -3938,8 +3938,9 @@ it aborts processing with a diagnostic message.
 .
 .
 .PP
-Multiple line spacing is not supported
-(use a larger vertical spacing instead).
+Multiple line spacing is not supported.
+.
+Use a larger vertical spacing instead.
 .
 .
 .PP
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index f88ccc020..1aa22b994 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -2290,8 +2290,8 @@ they cannot be used with AT&T
 .IR troff .
 .
 .I groff ms
-supports several features described above as Berkeley and Tenth Edition
-Research Unix extensions,
+supports features described above as Berkeley and Tenth Edition Research
+Unix extensions,
 and adds several of its own.
 .
 .
@@ -2323,7 +2323,7 @@ Bell Laboratories,
 The error-handling policy of
 .I groff ms
 is to detect and report errors,
-rather than silently to ignore them.
+rather than to ignore them silently.
 .
 .
 .IP \[bu]
@@ -2346,8 +2346,9 @@ it aborts processing with a diagnostic message.
 .
 .
 .IP \[bu]
-Multiple line spacing is not supported
-(use a larger vertical spacing instead).
+Multiple line spacing is not supported.
+.
+Use a larger vertical spacing instead.
 .
 .
 .IP \[bu]
@@ -2728,8 +2729,10 @@ macros contain only uppercase letters and digits.
 .
 .
 .LP
-Internally the macros are divided into modules;
-naming conventions are as follows:
+Internally,
+the macros are divided into modules.
+.
+Conventions for identifier names are as follows.
 .
 .IP \[bu] 3n
 Names used only within one module are of the form
-- 
cgit v1.2.1