> As a *roff user since the mid-1970s I am all too aware that to be > good at this you have to know and _understand_ a lot of details > about the document models (as represented by the different macro > collections: man, mm, mom, ms ...) and the fundamental commands, > registers, etc. To do even the simplest document requires > much-too-much expertise for the rank beginner.
Indeed. > The other day I was thinking of creating, as a first step, a set of > overlay macros for things like groff_mm (my macro package of choice) > to ease the burden of learning and understanding it: > > .mm_AbstractStart .AS > .mm_AbstractEnd .AE > .mm_Approval .AV > .mm_AuthorsTitle .AT > .mm_Author .AU > : : > .mm_PageHeader .PH > .mm_PageHeaderExit .PX > .mm_Paragraph .P > .mm_PictureStart .PS > .mm_PictureEnd .PE > : : Since mm isn't intended to be used with any other main macro package, I would omit the `mm_' prefix completely. Besides that, having slightly longer but more verbose commands are a good thing. It's really simple to provide such a `front end' by yourself; simply use the `.als' request for that purpose: .als AbstractStart AS .als AbstractEnd AE .als Approval AV .als AuthorsTitle AT .als Author AU : : .als PageHeader PH .als PageHeaderExit PX .als Paragraph P .als PictureStart PS .als PictureEnd PE : : Werner