 ;; --  logging ----------------------------------------------------------------
 
 (defn set-loggers!
-  "Internally, re-frame outputs warnings, errors etc via logging functions: `warn`, `log`, `error`, `group` and `groupEnd`
-
-  By default, these functions map directly to their default `js/console` implementations,
-  but you can override that with your own functions (set or subset). 
-
-  `new-loggers` should be a map containing a subset of they keys for the standard `loggers`.
+  "re-frame outputs warnings and errors via the API function `console` 
+   which, by default, delegates to `js/console`'s default implementation for 
+  `log, `error`, `warn` `debug` `group` `groupEnd`. But, using this function,
+   you can override that behaviour with your own functions. 
+
+  The argument `new-loggers` should be a map containing a subset of they keys 
+  for the standard `loggers`, namely  `:log` `:error` `:warn` `:debug` `:group` 
+  or `:groupEnd`.
 
   Example Usage:
 
-      (defn my-logger      ;; here is my alternative logging function
+      (defn my-logger      ;; my alternative logging function
         [& args]
         (post-it-somewhere (apply str args)))
 


      (console :error \"Oh, dear God, it happened:\" a-var \"and\" another)
      (console :warn \"Possible breach of containment wall at:\" dt)
   "
  [level & args]
  (apply loggers/console (into [level] args)))


  ([id interceptors handler]
   (events/register id [cofx/inject-db fx/do-fx std-interceptors/inject-global-interceptors interceptors (ctx-handler->interceptor handler)])))

(defn clear-event
  "Unregisters event handlers (presumably registered previously via the use of `reg-event-db` or `reg-event-fx`). 
   
  When called with no args, it will unregister all currently registered event handlers. 
   
  When given one arg, assumed to be the `id` of a previously registered 
  event handler, it will unregister the associated handler. Will produce a warning to 
  console if it finds no matching registration."
  ([]
   (registrar/clear-handlers events/kind))
  ([id]
