    (registrar/clear-handlers subs/kind query-id)))
 
 (defn clear-subscription-cache!
-  "Causes all subscriptions to be removed from the cache.
-  Does this by:
-     1. running `on-dispose` on all cached subscriptions
-     2. Each `on-dispose` will perform the removal of themselves.
-
-  This is for development time use. Useful when reloading Figwheel code
-  after a React exception, because React components won't have been
+  "Removes all subscriptions from the cache.
+
+  This is for development time use. Useful when hot realoding reloading 
+  to subscription code or after a React/render exception, because React components won't have been
   cleaned up properly. And this, in turn, means the subscriptions within those
-  components won't have been cleaned up correctly. So this forces the issue."
+  components won't have been cleaned up correctly. So this forces the issue.
+     
+   Implementation note: it calls `on-dispose` for each cached item, 
+   and it is that fucntion which actually performs the cache removal.
+   "
   []
   (subs/clear-subscription-cache!))
 
 (defn reg-sub-raw
   "This is a low level, advanced function.  You should probably be
-  using reg-sub instead.
-  Docs in
+  using `reg-sub` instead.
+   
+  Some docs are available in
   <a href=\"http://day8.github.io/re-frame/flow-mechanics/\" target=\"_blank\">http://day8.github.io/re-frame/flow-mechanics/</a>"
   [query-id handler-fn]
   (registrar/register-handler subs/kind query-id handler-fn))

  (utils/apply-kw interceptor/->interceptor m))

(defn get-coeffect
  "A utility function, typically used when writing an interceptor's `:before `function.  
   
   When called with one argument, it returns the `:coeffects` map from with that `context`.
   

   By default, these functions map directly to the default `js/console` implementations,
   but you can override with your own fns (set or subset) if you wish to handle the logging yourself.
   
   `new-loggers` should be a map containing a subset of they keys for the standard `loggers`.

  Example Usage:
   
      (defn my-logger      ;; here is my alternative logging function
        [& args]  
        (post-it-somewhere (apply str args))) 
   
      ;; now install my alternative loggers 
      (re-frame.core/set-loggers!  {:warn my-logger :log my-logger})      
   "
  [new-loggers]
  (loggers/set-loggers! new-loggers))
