Paul DuBois <> writes:
> My main difficulty with the manpages stylesheet actually stems from the
> stylesheet itself but with the DocBook DTD. I have a long reference manual
> that contains some sections that describe programs and how to invoke them.
> That is, these sections have content from which I want to produce manpages.
> (The source document is dual purpose: I want to generate both the long
> manual, and also a set of manpages.)
>
> Unfortunately, several of these program-description sections occur at the
> same "level" and in the same chapter as non-manpage sections. It appears
> that the DocBook DTD doesn't allow <section> and <refentry> to occur at the
> same level within the same parent. That means I cannot markup the
> program-description sections to use <refentry> rather than <section>.
So you could do this:
<section>
<title>The dog program</title>
<refentry>
<refnamediv>
<refname>dog</refname>
<refpurpose>better than cat </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<para>...</para>
</refsect1>
</refentry>
</section>
That is, make the Refentry a child of a Section.
--Mike
