Some of the syntax used in the README.adoc file wasn't correct asciidoc.

At the same time the set of possible usages wasn't complete without
documentation about lists generation.