 ;; --  Deprecation ------------------------------------------------------------
 ;; Assisting the v0.7.x ->  v0.8.x transition.
 (defn register-handler
+  "Deprecated. Use `reg-event-db` instead."
   {:deprecated "0.8.0"}
   [& args]
   (console :warn  "re-frame:  \"register-handler\" has been renamed \"reg-event-db\" (look for registration of" (str (first args)) ")")
   (apply reg-event-db args))
 
 (defn register-sub
+  "Deprecated. Use `reg-sub-raw` instead."
   {:deprecated "0.8.0"}
   [& args]
   (console :warn  "re-frame:  \"register-sub\" is deprecated. Use \"reg-sub-raw\" (look for registration of" (str (first args)) ")")

   (subs/subscribe query dynv)))

(defn clear-sub ;; think unreg-sub
  ([]
   (registrar/clear-handlers subs/kind))
  ([id]
   (registrar/clear-handlers subs/kind id)))

(defn clear-subscription-cache!
  "Causes all subscriptions to be removed from the cache.

   (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]
   (interceptor/get-effect context))
  ([context key]
