 
 
 (defn console
-  "A utility logging function to be used by libraries which 
-  extend re-frame, like perhaps an effect handler.
-
-  It will write the given `args` to js/console at the given log `level`.
+  "A utility logging function which is used internally within re-frame to produce 
+  warnings and other output. It can also be used by libraries which 
+  extend re-frame, such as effect handlers.
+
+  By default, it will output the given `args` to `js/console` at the given log `level`.
+  However, an application using re-frame can redirect `console` output via `set-loggers!`. 
 
   `level` can be one of `:log` `:error` `:warn` `:debug` `:group` `:groupEnd`.
 

  "This is a low level, advanced function.  You should probably be
  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))

  [interceptor]
  (settings/reg-global-interceptor interceptor))

(defn clear-global-interceptor
  "Unregisters global interceptors (presumably registered previously via the use of `reg-global-interceptor`). 
   
  When called with no args, it will unregister all currently registered global interceptors. 
   
  When given one arg, assumed to be the `id` of a previously registered 
  global interceptors, it will unregister the associated interceptor. Will produce a warning to 
  console if it finds no matching registration."
  ([]
   (settings/clear-global-interceptors))
  ([id]
