   (let [[amap tail banner]
         (cli/cli args
 
-; For the brush, theme, and stylesheet options the program first tries to read
-; from the filesystem and if that fails because the file is not found the
-; an attempt is made to read from the program's resources. The resources
-; contain the standard SyntaxHighlighter brushes and themes under their normal
-; file names including an additional `shBrushClojure.js` and
-; `shThemeClojure.css`.
-;
-; Multiple brushes can be used by repeating the `-b` or `--brush` options.
-; Additional brushes may be added by the program as a result of file includes
-; and file suffixes.
+; Here is a list of the options this program can take when run from the
+; commandline.
 
                  ["-c" "--comment" "Comment syntax" :default ";"]
                  ["-b" "--brush" "SyntaxHighlighter brush file" :multi true]


; ## Look and feel
;
; All javascript and CSS is inlined in the output.

(defn- inline-js [s]
  (println "<script>" s "</script>"))

(defn- inline-css [s]
  (println "<style>" s "</style>"))

; The default SyntaxHighlighter brush and theme (clojure and eclipse) can be
; overridden on the commandline, and an additional stylesheet can be included
; too.

(defn inline-brushes []
  (message "Adding the following brushes to output:")

;
; A few objects need to be accessed by a number of functions: regular
; expressions that match the beginning of commented lines, SyntaxHighlighter
; options, a PegDownProcessor, and a modified LinkRenderer. The dynamic
; variables are bound once for each file that is processed and are not mutated
; at any other time.
;
; ### Parsing variables

