Make it parse properly

Apparently there was still problems with the review 111083.
I adapted the docbook code to make it build guided by the parser
complaints. That should complete Pino's commit.

CCMAIL: montel@kde.org
CCMAIL: lueck@hube-lueck.de
CCMAIL: scarlett@scarlettgatelyclark.com
CCMAIL: pino@kde.org