> 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

Reply via email to