[groff] 07/08: [ms]: Tweak introduction/abstract.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 017371c18cf8459a7bdb80075548d88914064319
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed May 5 04:02:02 2021 +1000

    [ms]: Tweak introduction/abstract.
    
    Tighten wording, promote more noteworthy package features, and improve
    historical precision given the diversity of ms implementations.
---
 doc/groff.texi      | 15 +++++++++------
 doc/ms.ms           | 50 ++++++++++++++++----------------------------------
 tmac/groff_ms.7.man | 52 ++++++++++++++++++++++++++++++++++++++++------------
 3 files changed, 65 insertions(+), 52 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 7b54458..3686787 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -2410,14 +2410,17 @@ documentation.
 @cindex @code{ms} macros
 
 The @file{ms} (``manuscript'') package is suitable for the preparation
-of reports, letters, memoranda, books, and manuals.  These @code{groff}
-macros support cover page and table of contents generation, section
-headings, multiple paragraph styles, text styling (including font
-changes), lists, footnotes, pagination control, and indexing.
-
+of letters, memoranda, reports, and books.  These @code{groff}
+macros feature cover page and table of contents generation, automatic
+section numbering, several different paragraph styles, a variety of text
+styling options, footnotes, multi-column page layouts, and indexing.
 @file{ms} supports the @command{tbl}, @command{eqn}, @command{pic}, and
 @command{refer} preprocessors for inclusion of tables, mathematical
-equations, diagrams, and standardized bibliographic citations.
+equations, diagrams, and standardized bibliographic citations.  This
+implementation is mostly compatible with the documented interface and
+behavior of AT&T Version@tie{}7 Unix @file{ms}.  Several extensions from
+4.2BSD @c Few changes were made in 4.3, Tahoe, Reno, or 4.4.
+and Version@tie{}10 Research Unix have been recreated.
 
 @menu
 * ms Introduction::
diff --git a/doc/ms.ms b/doc/ms.ms
index dc410d6..8199d66 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -38,28 +38,22 @@ kollar@alltel.net
 .AB no
 The
 .I ms
-(\[lq]manuscript\[rq]) package is suitable for the preparation
-of reports,
+(\[lq]manuscript\[rq]) package is suitable for the composition of
 letters,
 memoranda,
-books,
-and manuals.
+reports,
+and books.
 .
 These
 .I groff
-macros support cover page and table of contents generation,
-section
-headings,
-multiple paragraph styles,
-text styling
-(including font changes),
-lists,
+macros feature cover page and table of contents generation,
+automatic section numbering,
+several different paragraph styles,
+a variety of text styling options,
 footnotes,
-pagination control,
+multi-column page layouts,
 and indexing.
 .
-.
-.PP
 .I ms
 supports the
 .I tbl ,
@@ -71,6 +65,14 @@ preprocessors for inclusion of tables,
 mathematical equations,
 diagrams,
 and standardized bibliographic citations.
+.
+This implementation is mostly compatible with the documented interface
+and behavior of AT&T Version\~7 Unix
+.I ms .
+.
+Several extensions from 4.2BSD
+.\" Few changes were made in 4.3, Tahoe, Reno, or 4.4.
+and Version\~10 Research Unix have been recreated.
 .AE
 .
 .
@@ -110,26 +112,6 @@ possible publication.
 .
 .
 .PP
-The
-.I ms
-macro package included with
-.I groff
-is a complete re-implementation.
-.
-Some macros
-specific to
-.Acr AT&T
-or Berkeley
-.I ms
-are not included,
-while several features have been added;
-see section \[lq]Differences from
-.Acr AT&T
-.I ms \[rq]
-below.
-.
-.
-.PP
 In this document,
 a right arrow (\[->]) is used to indicate a tab character in the input.
 .
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 7a6037a..3f085d3 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -53,26 +53,54 @@ groff_ms \- GNU roff manuscript macro package for 
formatting documents
 .SH Description
 .\" ====================================================================
 .
-This manual page describes the GNU version of the
+The GNU implementation of the
 .I ms
-macros,
-part of the
+macros is part of the
 .I groff
 typesetting system.
 .
 The
 .I ms
-macros are mostly compatible with the documented behavior of the 4.3
-BSD Unix
-.I ms
-macros (see
-.I Differences from AT&T ms
-below for details).
+package is suitable for the composition of
+letters,
+memoranda,
+reports,
+and books.
+.
+.
+.LP
+These
+.I groff
+macros support cover page and table of contents generation,
+automatic section numbering,
+several different paragraph styles,
+a variety of text styling options,
+footnotes,
+multi-column page layouts,
+and indexing.
 .
-The
 .I ms
-macros are suitable for reports, letters, books, and technical
-documentation.
+supports the
+.IR \%@g@tbl (@MAN1EXT@),
+.IR \%@g@eqn (@MAN1EXT@),
+.IR \%@g@pic (@MAN1EXT@),
+and
+.IR \%@g@refer (@MAN1EXT@)
+preprocessors for inclusion of tables,
+mathematical equations,
+diagrams,
+and standardized bibliographic citations.
+.AE
+.
+.
+.LP
+This implementation is mostly compatible with the documented interface
+and behavior of AT&T Version\~7 Unix
+.IR ms .
+.
+Several extensions from 4.2BSD
+.\" Few changes were made in 4.3, Reno, Tahoe, or 4.4.
+and Version\~10 Research Unix have been recreated.
 .
 .
 .\" ====================================================================