 
 
 (defn reg-global-interceptor
-  "Registers `interceptor` as a global interceptor. Global interceptors are
-   included in the processing of every event.
+  "Registers the given `interceptor` as a global interceptor. Global interceptors are
+   included in the processing chain of every event.
 
    When you register an event handler you have the option of supplying an
    interceptor chain. Any global interceptors you register are effectively
-   prepending to this chain. 
+   prepending to this chain.
   
    Global interceptors are run in the order that they are registered."
   [interceptor]


;; -- interceptors ------------------------------------------------------------

;; Standard interceptors.
;; Detailed docs on each in std-interceptors.cljs
(def debug
  "An interceptor which logs/instruments an event handler's actions to
  `js/console.debug`. See examples/todomvc/src/events.cljs for use.

  Output includes:
  1. the event vector
  2. a `clojure.data/diff` of db, before vs after, which shows
     the changes caused by the event handler. To understand the output,

     ```

  3. Syntax Sugar
     ```clj
     (reg-sub
       :a-b-sub
