gbranden pushed a commit to branch master
in repository groff.
commit 99812d1789aa25be54a671f3fbf7d1b7b3300de9
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Apr 24 11:55:27 2026 -0500
[ms]: Resync documentation.
...among the 3 formats in which we currently maintain it. :-O
---
doc/groff.texi.in | 41 +++++++++++++++++++++++------------------
tmac/groff_ms.7.man | 32 ++++++++++++++------------------
2 files changed, 37 insertions(+), 36 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 0366b4ce4..dedbc627c 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -5288,33 +5288,38 @@ and adds several of its own.
The internals of
@code{groff}
@file{ms}
-differ from those of @acronym{AT&T}
+differ from those of @acronym{AT&T} and Berkeley
@file{ms}.
-Documents that depend upon implementation details of @acronym{AT&T}
-@file{ms}
-may not format properly with
+Documents that depend upon implementation details of
+those implementations
+might not format as expected with
@code{groff}
@file{ms}.
-Such details include macros whose function was not documented in the
-@acronym{AT&T}
+It therefore defines the register
+@code{GS}
+.CW GS ,
+which @acronym{AT&T} and Berkeley do not use,
+to@tie{}1.
+A document can test its value to determine whether it is being formatted
+with
+@code{groff}
@file{ms}
-@c XXX: Texinfo's @cite command conceives only of citations of long-form
-@c works, like books, and forces italics. APA, MLA, and Chicago styles
-@c all agree that article citations are set in roman. MLA and Chicago
-@c furthermore place them within quotation marks.
-manual.@footnote{``Typing Documents on the UNIX System: Using the
--ms Macros with Troff and Nroff'', M.@tie{}E.@: Lesk, Bell Laboratories,
-1978}
-@c XXX: We support RT anyway; maybe we should stop?
+or another implementation.
@item
-The error-handling policy of @code{groff} @file{ms} is to detect and
-report errors, rather than to ignore them silently.
+The error-handling policy of
+@code{groff}
+@file{ms}
+is to detect and report errors,
+rather than to ignore them silently.
@item
Research Tenth Edition @c possibly 9th
-Unix supported @code{P1}/@code{P2} macros to bracket code
-examples; @code{groff} @file{ms} does not.
+Unix supported
+@code{P1}/@code{P2}
+macros to bracket code examples;
+@code{groff}
+@file{ms} does not.
@item
@code{groff}
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 0faa3ab0d..db9f79a28 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -2363,27 +2363,23 @@ and adds several of its own.
.IP \[bu] 3n
The internals of
.I groff ms
-differ from those of
-AT&T
+differ from those of AT&T and Berkeley
.IR ms .
.
-Documents that depend upon implementation details of
-AT&T
-.I ms
-may not format properly with
-.IR "groff ms" .
+Documents that depend upon undocumented behavioral details of
+those implementations
+might not format as expected with
+.I groff ms.
.
-Such details include macros whose function was not documented in the
-AT&T
-.I ms
-manual
-(\[lq]Typing Documents on the UNIX System: Using the \-ms Macros with
-Troff and Nroff\[rq],
-M.\& E.\& Lesk,
-Bell Laboratories,
-1978).
-.\" TODO: Use refer(1)?
-.\" XXX: We support RT anyway; maybe we should stop?
+It therefore defines the register
+.BR GS ,
+which AT&T and Berkeley do not use,
+to\~1.
+.
+A document can test its value to determine whether it is being formatted
+with
+.I groff ms
+or another implementation.
.
.
.IP \[bu]
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
