   (utils/apply-kw interceptor/->interceptor m))
 
 (defn get-coeffect
-  "When called with one arg, returns the coeffects map from the `context`.
-   When called with two or three args, behaves like `clojure.core/get`, 
-   returns the value mapped to `key` in the coeffects map, `not-found` or
+  "A utility function, used when writing interceptors, typically within a `:before` function. 
+   
+   When called with one argument, it returns the `:coeffects` map from with that `context`.
+   
+   When called with two or three arguments, behaves like `clojure.core/get` and
+   returns the value mapped to `key` in the `:coeffects` map within `context`, `not-found` or
    `nil` if `key` is not present."
   ([context]
    (interceptor/get-coeffect context))

   (interceptor/get-coeffect context key not-found)))

(defn assoc-coeffect
  "Returns a new `context` with a new coeffects map that contains `key`
   mapped to the `value`."
  [context key value]
  (interceptor/assoc-coeffect context key value))

(defn get-effect
  "When called with one arg, returns the effects map from the `context`.
   When called with two or three args, behaves like `clojure.core/get`, 
   returns the value mapped to `key` in the effects map, `not-found` or
   `nil` if `key` is not present."
  ([context]


   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. 
  
   Global interceptors are run in the order that they are registered."
  [interceptor]
  (settings/reg-global-interceptor interceptor))

(defn clear-global-interceptor ;; think unreg-global-interceptor
  "Unregisters (removes) global interceptors. 
   
   When called with no arguments, it unregisters all global interceptors. When given
   one argument, assumed to be the `id` of a currently registered global
   interceptor, it unregisters the associated interceptor."
  ([]
   (settings/clear-global-interceptors))
  ([id]
   (settings/clear-global-interceptors id)))


(defn ->interceptor
  "A utility function for creating interceptors. 
   
   Accepts three optional, named arguments:
   
     - `:id` - an id for the interceptor (decorative only)
     - `:before` - the before function 
     - `:after`  - the after function 
