[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 04/04: doc/groff.texi: Tweak macro package descriptions.
From: |
G. Branden Robinson |
Subject: |
[groff] 04/04: doc/groff.texi: Tweak macro package descriptions. |
Date: |
Sun, 23 Dec 2018 14:33:40 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit 2212cba0fadf49e75d520d341238d4badc80769c
Author: G. Branden Robinson <address@hidden>
Date: Sat Dec 15 09:19:47 2018 -0500
doc/groff.texi: Tweak macro package descriptions.
* Note that mdoc and me originate with BSD.
* Note mm's origins at AT&T.
* Add mnemonic reminders of the "meanings" of "mm" and "ms".
* Remove comments promising future flesh-outs in Texinfo format. That's
probably not going to happen.
Signed-off-by: G. Branden Robinson <address@hidden>
---
doc/groff.texi | 41 +++++++++++++++++++++++------------------
1 file changed, 23 insertions(+), 18 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 0d99650..f338ec8 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -2391,10 +2391,9 @@ are printed in Helvetica Bold.
@section @file{mdoc}
@cindex @code{mdoc} macros
address@hidden XXX documentation
address@hidden XXX this is a placeholder until we get stuff knocked into shape
-See the @cite{groff_mdoc(7)} man page (type @command{man groff_mdoc}
-at the command line).
address@hidden's implementation of the BSD @file{doc} package for man
+pages is documented in the @cite{groff_mdoc(7)} man page. Type
address@hidden groff_mdoc} at the command line to view it.
@c =====================================================================
@@ -2403,10 +2402,15 @@ at the command line).
@section @file{me}
@cindex @code{me} macro package
address@hidden XXX documentation
address@hidden XXX this is a placeholder until we get stuff knocked into shape
-See the @file{meintro.me} and @file{meref.me} documents in groff's
address@hidden directory.
address@hidden's implementation of the BSD @file{me} macro package is
+documented using itself. A tutorial, @file{meintro.me}, and reference,
address@hidden, are available in @code{groff}'s documentation
+directory. A @cite{groff_me(7)} man page is also available and
+identifies the installation path for these documents. Type @command{man
+groff_me} at the command line to view it.
+
+A French translation of the tutorial is available as
address@hidden and installed parallel to the English version.
@c =====================================================================
@@ -2415,10 +2419,12 @@ See the @file{meintro.me} and @file{meref.me} documents
in groff's
@section @file{mm}
@cindex @code{mm} macro package
address@hidden XXX documentation
address@hidden XXX this is a placeholder until we get stuff knocked into shape
-See the @cite{groff_mm(7)} man page (type @command{man groff_mm} at the
-command line).
address@hidden's implementation of the @acronym{AT&T} memorandum macro
+package is documented in the @cite{groff_mm(7)} man page. Type
address@hidden groff_mm} at the command line) to view it.
+
+A Swedish localization of @file{mm} is also available; see
address@hidden(7)}.
@c =====================================================================
@@ -2427,8 +2433,6 @@ command line).
@section @file{mom}
@cindex @code{mom} macro package
address@hidden XXX documentation
address@hidden XXX this is a placeholder until we get stuff knocked into shape
The main documentation files for the @file{mom} macros are in
@acronym{HTML} format. Additional, useful documentation is in
@acronym{PDF} format. See the @cite{groff(1)} man page, section
@@ -2460,16 +2464,17 @@ The @cite{groff_mom(7)} man page (type @command{man
groff_mom} at the
command line) contains a partial list of available macros, however their
usage is best understood by consulting the @acronym{HTML} documentation.
+
@c =====================================================================
@node ms, , mom, Macro Packages
@section @file{ms}
@cindex @code{ms} macros
-The @file{-ms} macros are suitable for reports, letters, books, user
-manuals, and so forth. The package provides macros for cover pages,
-section headings, paragraphs, lists, footnotes, pagination, and a table
-of contents.
+The @file{-ms} (``manuscript'') macros are suitable for reports,
+letters, books, user manuals, and so forth. The package provides macros
+for cover pages, section headings, paragraphs, lists, footnotes,
+pagination, and a table of contents.
@menu
* ms Intro::
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 04/04: doc/groff.texi: Tweak macro package descriptions.,
G. Branden Robinson <=