Re: Instructions for minimal documents

[G. Branden Robinson]

Hi Oliver,

At 2023-11-21T13:37:13+0100, Oliver Corff via wrote:
> while experimenting with the mm macro package for the first time I
> noticed that from the very start it did not behave exactly as expected
> --- which was entirely due to my lacking of understanding of some
> basics.

Before digging into the details of your message, can you confirm if
you're using the version of the groff_mm(7) man page from 1.22.4,
1.23.0, or Git?

I ask because I've done a lot of work on the page, some if it in the
areas you've expressed frustration with.

For example:

Description
     The GNU implementation of the mm macro package is part of the groff
     document formatting system.  The mm package is suitable for the
     composition of letters, memoranda, reports, and books.

     Call an mm macro at the beginning of a document to initialize the
     package.  A simple mm document might use only P for paragraphing.
     Set numbered and unnumbered section headings with H and HU,
     respectively.  Change the style of the typeface with B, I, and R;
     you can alternate styles with BI, BR, IB, IR, RB, and RI.  Several
     nestable list types are available via AL, BL, BVL, DL, ML, RL, and
     VL; each of these begins a list, to which LI adds an item and LE
     ends the (nested) list.  Customized list arrangements are supported
     by LB.  DS and DF start static and floating displays, respectively;
     either is terminated with DE.
[...]
   Document styles
     groff mm offers three different frameworks for document
     organization.  COVER/COVEND is a flexible means of preparing any
     document requiring a cover page.  LT/LO aids preparation of typical
     Anglophone correspondence (business letters, for example).  The MT
     memorandum type mechanism implements a group of formal styles
     historically used by AT&T Bell Laboratories.  Your document can
     select at most one of these approaches; when used, each disables
     the others.
[...]

Regards,
Branden

signature.asc
Description: PGP signature