[groff] 04/04: doc/groff.texi: Tweak macro package descriptions.

[G. Branden Robinson]

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::