I've got a love-hate relationship with DocBook: I love the structured markup, and hate the various quirky toolchains and the difficulty of customizing both the DocBook markup format and the appearance of the output. Luckily, these things are slowly improving.