[Top][All Lists]
[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