[groff] 05/13: [ms]: Tweak and tighten documentation.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 7d5e0d6ee00ec650d35d4f0af34adda1aa6cb371
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Oct 4 15:19:01 2024 -0500

    [ms]: Tweak and tighten documentation.
---
 doc/groff.texi.in   |  4 ++--
 doc/ms.ms           | 10 +++-------
 tmac/groff_ms.7.man |  4 ++--
 3 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 3d70ff8c8..df7ae39ea 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -2721,11 +2721,11 @@ Wallace after the criticality incident.
 @node ms Document Structure, ms Document Control Settings, ms Introduction, ms
 @anchor{General ms Structure} @c 1.22.4
 @subsection Document Structure
-@cindex @file{ms} macros, general structure
+@cindex @file{ms} document structure
 
 The @file{ms} macro package expects a certain amount of structure:
 a well-formed document contains at least one paragraphing or heading
-macro call.  Longer documents have a structure as follows.
+macro call.  Organize longer documents as follows.
 
 @table @strong
 @item Document type
diff --git a/doc/ms.ms b/doc/ms.ms
index af9b6673b..725e05270 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -392,13 +392,9 @@ Wallace after the criticality incident.
 .  bp
 .\}
 .NH 1
-General structure of an
-.BI ms
-document
+Document structure
 .XS
-General structure of an
-.I ms
-document
+Document structure
 .XE
 .
 .
@@ -409,7 +405,7 @@ macro package expects a certain amount of structure:
 a well-formed document contains at least one paragraphing or heading
 macro call.
 .
-Longer documents have a structure as follows.
+Organize longer documents as follows.
 .
 .
 .IP "\fBDocument type\fP"
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index c53f2ec15..77cd60b42 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -116,7 +116,7 @@ and Research Tenth Edition Unix have been recreated.
 .
 .
 .\" ====================================================================
-.SH Usage
+.SH "Document structure"
 .\" ====================================================================
 .
 The
@@ -133,7 +133,7 @@ begin it by calling
 or
 .BR .PP .
 .
-Longer documents have a structure as follows.
+Organize longer documents as follows.
 .
 .
 .TP