Re: [docbook] Markup suggestions please?

[Richard Hamilton <hamilton@xmlpress.net>]

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
hamilton@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 &pi;</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-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org
>