gbranden pushed a commit to branch master
in repository groff.
commit b17822e31edc63b74f489d36f8c5d64457da7ea7
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat May 16 14:17:47 2026 -0500
[doc,man]: List full-service packages.
...in "Invocation" node of our Texinfo manual.
Per suggestion by Karl Berry.
---
doc/groff.texi.in | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++--
man/groff_tmac.5.man | 6 ++--
2 files changed, 83 insertions(+), 5 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index ba35b6bd8..2fb45a984 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -1307,8 +1307,12 @@ does not prefix an option dash to @var{arg} before
passing it to the
spooler.
@item -m @var{mac}
-Search for the macro package @file{@var{mac}.tmac} and read it prior to
-any input. If not found, @file{tmac.@var{mac}} is attempted.
+Search for the macro package
+@file{@var{mac}.tmac}
+and read it prior to any input.
+If not found,
+@file{tmac.@var{mac}}
+is attempted.
@xref{Macro Directories}.
@command{groff}
passes
@@ -1319,6 +1323,80 @@ options and their arguments to
and
@command{@g@grn}.
+The following ``full-service'' macro packages
+are available.
+.
+@cite{groff_tmac@r{(5)}}
+documents these and many other,
+``auxiliary'', packages.@footnote{@xref{Macro Packages}.}
+
+@c BEGIN Keep parallel with groff_tmac(5), subsection "Man pages".
+Two full-service macro packages are specialized for formatting Unix
+reference manuals;
+they do not support features like footnotes or multiple columnation.
+
+@table @code
+@item man
+constructs man pages in a format introduced
+by Seventh Edition Unix (1979).
+Its macro interface is small,
+and the package widely used;
+see @cite{groff_man@r{(7)}}.
+
+@item mdoc
+constructs man pages in a format introduced by 4.3BSD-Reno (1990).
+It provides many more features than
+@file{man}
+but is also larger,
+more complex,
+and not as widely adopted;
+see @cite{groff_mdoc@r{(7)}}.
+
+@item mandoc
+recognizes a document's use of
+@file{man}
+or
+@file{mdoc}
+and loads the corresponding macro package.
+Multiple man pages,
+in either format,
+can be handled;
+@file{mandoc}
+reloads each macro package as necessary.
+@end table
+@c END Keep parallel with groff_tmac(5), subsection "Man pages".
+
+@c BEGIN Keep parallel with groff_tmac(5), subsection "General
+@c full-service packages".
+The following packages each support composition of documents
+of any kind,
+from single-page memos to lengthy monographs.
+They are similar in functionality;
+select one that suits your taste.
+
+@table @code
+@item me
+originates in 2BSD (1978);
+see @cite{groff_me@r{(7)}}.
+
+@item mm
+originates in Programmer's Workbench (PWB) Unix 1.0 (1977);
+see @cite{groff_mm@r{(7)}}.
+
+@item mom
+was contributed to
+@code{groff}
+in 2002,
+and freely exercises its many extended features.
+see @cite{groff_mom@r{(7)}}.
+
+@item ms
+originates in Sixth Edition Unix (1975);
+see @cite{groff_ms@r{(7)}}.
+@end table
+@c END Keep parallel with groff_tmac(5), subsection "General
+@c full-service packages".
+
@item -M @var{dir}
Search directory @file{@var{dir}} for macro files. @xref{Macro
Directories}.
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index a1d89b83d..13762fea7 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -236,7 +236,7 @@ and loads the corresponding macro package.
Multiple man pages,
in either format,
can be handled;
-.I \%andoc
+.I \%mandoc
reloads each macro package as necessary.
.
.
@@ -244,8 +244,8 @@ reloads each macro package as necessary.
.SS "General full-service packages"
.\" ====================================================================
.
-The following packages each support composition of documents of any
-kind,
+The following packages each support composition of documents
+of any kind,
from single-page memos to lengthy monographs.
.
They are similar in functionality;
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
