 
 ; ## Look and feel
 ;
-; All javascript and CSS is inlined in the output.
-
-(defn- inline-js [s]
+; All javascript and CSS are inlined in the output.
+
+(defn inline-js [s]
   (println "<script>" s "</script>"))
 
-(defn- inline-css [s]
+(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.
+; SyntaxHighlighter brushes can be set and the default theme
+; (`shThemeEclipse.css`) overridden on the commandline. An additional
+; stylesheet can also be set.
+;
+; Because lack of brush or theme will not materially affect the structure of
+; the output page, failure to load one or more of them will not cause the
+; program to halt, though it will be logged to standard-error.
 
 (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. Of these, the
; processor and renderer are never dynamically bound. The other variables are
; bound once for the lifetime of the program, so for the rest of the program
; they can be considered constant.
;
; ### Parsing variables


; style and behaviour information first, followed by visible content, followed
; by the javascript entry-point.

(defn render-files [paths]
  (println
    "<!doctype html>"
    "<meta charset=utf-8>")
