I tried to explain, why it's better to use $(...) rather than
backticks when writing scripts.

Furthermore some corrections concerning asciidoc's formatting were
made.

There are two different versions attached.

  1. Uses intended blocks for displaying source snippets as the
     current version does.
  2. Makes use of source-highlight for colored source snippets.