Dave, It might be overkill, but I'd suggest taking a look at the refentry markup. It is designed for reference material like this.
Dick ------- XML Press XML for Technical Communicators http://xmlpress.net hamil...@xmlpress.net On Dec 6, 2011, at 5:44 AM, davep wrote: > Using db 5.0 > > I'm describing a suite of assembler instructions. > I would like to have the set available, sorted in a toc/index somewhere. > This is my best guess so far. > Improvement suggestions appreciated. Basic content is > name, description, syntax, example {notes} > > I note docbook is missing something more explicit than <code> for > an actual instruction. > > <section xml:id='mul'> > <title>mul</title> > <para role='desc'>Multiply, Multiply Accumulate, and Multiply Subtract > (32-bit by > 32-bit, bottom 32-bit result). Note, <code>mls</code> is not available to > π</para> > <screen role="syntax"> > mul{s}{cond} {Rd}, Rn, Rm > </screen> > <programlisting> > mul r0, r1, r2 @ r0 = r1 * r2 > </programlisting> > <para role='note'> > Returns the ls 'word' of the result in r0. @FIXME, where is the > msword? > </para> > </section> > > > TIA > > > > regards > > -- > Dave Pawson > XSLT XSL-FO FAQ. > http://www.dpawson.co.uk > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org > For additional commands, e-mail: docbook-h...@lists.oasis-open.org > --------------------------------------------------------------------- To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org For additional commands, e-mail: docbook-h...@lists.oasis-open.org