   [defaults props]
   (util/merge-props defaults props))
 
-(defn flush []
+(defn flush
+  "Render dirty components immediately to the DOM.
+
+Note that this may not work in event handlers, since React.js does
+batching of updates there."
+  []
   (comp/flush))
 
 


(defn render-component
  "Render a Reagent component into the DOM. The first argument may be either a
vector (using Reagent's Hiccup syntax), or a React component. The second argument
should be a DOM node.

Optionally takes a callback that is called when the component is in place.



;; Utilities

(defn next-tick
  "Run f using requestAnimationFrame or equivalent."
  [f]
  (comp/next-tick f))

(defn partial
