OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [docbook] man page: long and short opts


On Thu 2004-06-17 John L. Clark wrote:
> Conveniently, the varlistentry element has a content model which
> allows for an arbitrary number of terms; I have used this for
> essentially the same purpose - in describing both long and short
> options:
> 
>     <varlistentry>
>       <term><option>-t</option> <replaceable>name</replaceable></term>
>       <term><option>--top=</option><replaceable>name</replaceable></term>
>       <listitem>
>         <para>Specify the name of the root fragment to use to tangle the source; the default is "top".</para>
>       </listitem>
>     </varlistentry>
> 
> I think the point here is that a varlistentry maps any number of
> equivalent, abstract "terms" to their common description, which fits the
> use here precisely.

Thanks!

Tobi

-- 
to
  bi
    as
  re
if

PGP signature



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]