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.