Re: [docbook-apps] Refentry, man pages, and DocBook XSL 1.69.0

[Michael Smith <smith@xml-doc.org>]

Paul DuBois <paul@kitebird.com> 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

smime.p7s