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

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 2da1b404bb63e111683b24953f122ddd770a8c53
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jul 26 21:43:17 2022 -0500

    [ms]: Fix content and style nits in docs.
    
    * Genericize example with respect to text editor.  (It also happens to
      be a working command on Debian-based systems.)
    * Illustrate how to check a document for errors.
    * Clarify when it is the macro package, not the formatter, being
      instructed.
    * Tweak wording.
---
 doc/groff.texi      | 7 ++++---
 doc/ms.ms           | 7 ++++---
 tmac/groff_ms.7.man | 4 ++--
 3 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 679b70df1..2968699ab 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -2496,7 +2496,8 @@ Format the document with the @command{groff} command.  
@command{nroff}
 can be useful for previewing.
 
 @CartoucheExample
-$ vi radical.ms
+$ editor radical.ms
+$ nroff -ww -z -ms radical.ms # check for errors
 $ nroff -ms radical.ms | less -R
 $ groff -T ps -ms radical.ms > radical.ps
 $ see radical.ps
@@ -2623,7 +2624,7 @@ implementations are specific to @acronym{AT&T} or 
Berkeley, and are not
 supported by @code{groff} @file{ms}.
 
 @item Format and layout
-By setting registers and strings, you can change your document's
+By setting registers and strings, you can configure your document's
 typeface, margins, spacing, headers and footers, and footnote
 arrangment.  @xref{ms Document Control Settings}.
 
@@ -3939,7 +3940,7 @@ preprocessors match these tokens only at the start of an 
input line.
 @DefmacList {TS, [@code{H}], ms}
 @DefmacListEndx {TE, , ms}
 Demarcate a table to be processed by the @code{tbl} preprocessor.  The
-optional argument@tie{}@code{H} to @code{TS} instructs @code{groff} to
+optional argument@tie{}@code{H} to @code{TS} instructs @file{ms} to
 repeat table rows (often column headings) at the top of each new page
 the table spans, if applicable; calling the @code{TH} macro marks the
 end of such rows.  The GNU @cite{tbl@r{(1)}} man page provides a
diff --git a/doc/ms.ms b/doc/ms.ms
index b86a79ebc..c2eec839e 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -184,7 +184,8 @@ can be useful for previewing.
 .TS
 box center;
 lf(CB).
-\f[CR]$\f[] vi radical.ms
+\f[CR]$\f[] editor radical.ms
+\f[CR]$\f[] nroff -ww -z -ms radical.ms # check for errors
 \f[CR]$\f[] nroff \-ms radical.ms | less \-R
 \f[CR]$\f[] groff \-T ps \-ms radical.ms > radical.ps
 \f[CR]$\f[] see radical.ps
@@ -412,7 +413,7 @@ and are not supported by
 .
 .IP "\fBFormat and layout\fP"
 By setting registers and strings,
-you can change your document's typeface,
+you can configure your document's typeface,
 margins,
 spacing,
 headers and footers,
@@ -2376,7 +2377,7 @@ The optional
 argument to
 .CW .TS
 instructs
-.I groff
+.I ms
 to repeat table rows
 (often column headings)
 at the top of each new page the table spans,
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index c11bf2d1b..daefb1801 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -142,7 +142,7 @@ and are not supported in
 .TP
 .B "Format and layout"
 By setting registers and strings,
-you can change your document's typeface,
+you can configure your document's typeface,
 margins,
 spacing,
 headers and footers,
@@ -1463,7 +1463,7 @@ preprocessor.
 The optional
 .BR H "\~argument"
 instructs
-.I groff
+.I ms
 to repeat table rows
 (often column headings)
 at the top of each new page the table spans,