hi,
my original advice was not to use DocBook but rather this one: don't bother with decorations, the core of information is enough. i would even add, what's really missing most of the time is a _GOOD_ help patch, although latest releases on this list proved a real concern for that, and i'd like to encourage people doing it in that way :-).
another #ifndef MY_OPINION, i know....
bye,
Yves/