Spent some time trying to find out how to write definition lists in DocBook. DocBook is the markup language used by gtk-doc and consequently the tool I am using for writing documentation for GtkImageView.
... And I am very, VERY sick of it. It turns out it was fairly simple (heh), all you have to do to create a list of directories and paragraphs is this:
The result is almost exactly what you could have accomplised using this HTML:
And of course, even less markup is needed if you use reStructuredText.
My search for a decent documentation writing system continues.