   config-map:
    `:passes` is a sequence of functions constituting an optimization
     configuration. These functions must be
-    (λ form-seq → settings → form-seq)
+    (λ ast → settings → ast)
     and pure. It is expected but not enforced that passes may not
     emit nodes which an emitter does not support. If passes is empty
     no program transformations will be done and the emitter will be
     invoked directly.
 
-    `:emitter` is a single function which is λ form-seq → nil which
-    is expected to emit the appropriate classfiles as side effects.
+    `:emitter` is a single function which is λ ast → settings → nil
+    which is expected to emit the appropriate classfiles as side
+    effects.
 
     `:settings` may be a map containing `:passes` and `:emitter`,
     these being option maps which will be applied respectively at the
-    invocation of each pass and the emitter."
+    invocation of each pass and the emitter.
+
+    `[:settings :entry]` is expected to be a fully qualified symbol,
+    being a -main method or other program entry point."
 
   ([res]
      ;; FIXME:

           reader (readers/indexing-push-back-reader file 1 p)]
       (binding [*ns*                 *ns*
                 *file*               p
                 *load-configuration* options
                 clojure.core/load    oxcart/load
                 clojure.core/eval    oxcart/eval]
         (loop []
           (let [form (r/read reader false eof)]
             (when (not= eof form)
               (eval form options)
               (recur))))))
     nil))



       ;; to generate the forms and defs structures.
       (load res config)

       (let [settings (:passes settings)]
         (doseq [pass passes]
           (swap! forms pass settings)))

       ;; Having taken an O(Nᵏ) compile operation to the face we now
       ;; run the emitter and call it quits.
