improve docu wording
fix asciidoc misinterpretation

asciidoc was misinterpreting the '-----' (see patch) as underlining
the previous text instead of as starting the next source code section.

Inserting a newline in between to help asciidoc.
improve docu wording
Merge branch 'master' of https://github.com/tpo/cdist