<parameter role="ref" choice="opt">width</parameter>

But anyway Goba what tags (if any) do you suggest for this?

This last option seems to be fine with me.

Should go as far as adding the type here too?

<type>integer</type> <parameter role="ref" choice="opt">width</parameter>

VS

<parameter role="ref" choice"opt" type="integer">width</parameter>

Parameter has no type attribute, so only the former is possible.

Ups, parameter also has no choice attribute, it is of paramdef. Which in turn can only be added inside a funcprototype according to the DocBook DTD. Couldn't we come up with some DocBook friendly alternative? A good idea would be to somehow reference the parameter already defined in the funcprototype, so only one place needs editing when parameters get changed. Then livedocs could resolve the reference and copy the parameter info (type, by reference, name) to the right place in the variablelist.


Goba

Reply via email to