Documenting items with preceding '#:' style comments is only supposed
to work if there is noe blank lines between the comment and a given item.
However, the current logic means that this does not work and prodices a
#: The global configuration
#: This is used by pretty much everything, ...
The attached patch makes the above work as I would naively expect. First line
is the summary and the following lines provide details.