groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: <OK> Re: [Groff] ESR in manpages versus the WEB


From: Gunnar Ritter
Subject: Re: <OK> Re: [Groff] ESR in manpages versus the WEB
Date: Mon, 01 Jan 2007 18:54:52 +0100
User-agent: Heirloom mailx 12.2pre 12/28/06

M Bianchi <address@hidden> wrote:

> This would seem be argue for structural macros.  E.g.
>
>  .SH  NAME
>  .NamePurpose  "bzip2, bunzip2"  "a block-sorting file compressor, v1.0.3"
>  .NamePurpose  "bzcat"           "decompresses files to stdout"
>  .NamePurpose  "bzip2recover"    "recovers data from damaged bzip2 files"

These macros are rather superfluous as the structure is
implied by the "name \- purpose" convention in the name
section line anyway. Moreover, the name section is a
particularly bad place to use macros as it is not only
read by manual page viewers or converters, but also by
indexing tools like "apropos" or "whatis" (which rely
precisely on the "name \- purpose" scheme).

        Gunnar




reply via email to

[Prev in Thread] Current Thread [Next in Thread]