DOCBOOK: attaching text to cmdsynopsis

[davidw at dedasys dot com (David N. Welton)]

Hello,

First of all, I hope this list is the right place to be asking this, a
question about use of docbook, rather than the discussion of DTD
itself!  If not, my apologies.

Anyway, to the point:

I am documenting some commands:

    <cmdsynopsis>
      <command>Rivet_Script</command>
      <arg>ChildExitScript</arg>
      <arg><replaceable>script</replaceable></arg>
    </cmdsynopsis>
    <para>
      Script to be evaluated when each Apache child process exits.
    </para>

    <cmdsynopsis>
      <command>Rivet_Script</command>
      <arg>BeforeScript</arg>
      <arg><replaceable>script</replaceable></arg>
    </cmdsynopsis>
    <para>
      Script to be evaluated before each server parsed (.rvt) page.
    </para>

I'd like to "attach" the text in the para tags to the cmdsynopsis, to
make a unit out of it, in order to be able to process it better with
XSL, and so on.

Currently, this doesn't really work... the text is basically stand
alone, afer the cmdsynopsis.  What might be some better ways to do
this?  I thought about refentry, but that seems to be a little bit
overkill.  These are small commands - not something that merits an
entire man page of its own.  I could use a list, too, but then again,
functionally this isn't really a list, so that doesn't quite sit right
with me... I mean, docbook is about content, rather than layout, so
saying it's a list when it's not doesn't sound good.

Ideas?  Suggestions?

Thankyou for your time,
-- 
David N. Welton
   Consulting: http://www.dedasys.com/
     Personal: http://www.dedasys.com/davidw/
Free Software: http://www.dedasys.com/freesoftware/
   Apache Tcl: http://tcl.apache.org/