gbranden pushed a commit to branch master
in repository groff.
commit 75687c614db32e821a47c5bec4cf660716d50ca9
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Tue Jul 8 15:56:03 2025 -0500
doc/*,tmac/*: Revise ms introduction.
* Characterize citations generated by refer(1) as "consistently
formatted", not "standardized". Whether a "standard" applies to them
is not squarely on point.
* Favor active voice over passive.
* Identify the topic by name, not "this implementation".
---
doc/groff.texi.in | 17 +++++++++++------
doc/ms.ms | 9 +++++----
tmac/groff_ms.7.man | 11 ++++++-----
3 files changed, 22 insertions(+), 15 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 714bbcc09..eed816104 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -2595,13 +2595,18 @@ macros feature cover page and table of contents
generation,
automatically numbered headings, several paragraph styles, a variety of
text styling options, footnotes, and multi-column page layouts.
@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. This
-implementation is mostly compatible with the documented interface and
-behavior of AT&T Unix Version@tie{}7 @file{ms}. Many extensions from
-4.2BSD (Berkeley)
+@command{refer}
+preprocessors for inclusion of tables,
+mathematical equations,
+diagrams,
+and consistently formatted bibliographic citations.
+@code{groff} @file{ms}
+is mostly compatible with the documented interface
+and behavior of AT&T Unix Version\~7
+@code{ms}.
+It recreates most extensions from 4.2BSD (Berkeley)
@c Few changes were made in 4.3, Tahoe, Reno, or 4.4.
-and Research Tenth Edition Unix have been recreated.
+and Research Tenth Edition Unix.
@menu
* ms Introduction::
diff --git a/doc/ms.ms b/doc/ms.ms
index 029b12b28..d35146086 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -88,15 +88,16 @@ and
preprocessors for inclusion of tables,
mathematical equations,
diagrams,
-and standardized bibliographic citations.
+and consistently formatted bibliographic citations.
.
-This implementation is mostly compatible with the documented interface
+.I "groff ms"
+is mostly compatible with the documented interface
and behavior of AT&T Unix Version\~7
.I ms .
.
-Many extensions from 4.2BSD (Berkeley)
+It recreates most extensions from 4.2BSD (Berkeley)
.\" Few changes were made in 4.3, Tahoe, Reno, or 4.4.
-and Research Tenth Edition Unix have been recreated.
+and Research Tenth Edition Unix.
.AE
.
.
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 11cf4c97d..e32fb0989 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -102,17 +102,18 @@ and
preprocessors for inclusion of tables,
mathematical equations,
diagrams,
-and standardized bibliographic citations.
+and consistently formatted bibliographic citations.
.
.
-.LP
-This implementation is mostly compatible with the documented interface
+.P
+.I "groff ms"
+is mostly compatible with the documented interface
and behavior of AT&T Unix Version\~7
.IR ms .
.
-Many extensions from 4.2BSD (Berkeley)
+It recreates most extensions from 4.2BSD (Berkeley)
.\" Few changes were made in 4.3, Reno, Tahoe, or 4.4.
-and Research Tenth Edition Unix have been recreated.
+and Research Tenth Edition Unix.
.
.
.\" ====================================================================
_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
