diff --git a/reactive.cabal b/reactive.cabal
--- a/reactive.cabal
+++ b/reactive.cabal
@@ -1,5 +1,5 @@
 Name:                reactive
-Version:             0.10.0
+Version:             0.10.1
 Synopsis:            Simple foundation for functional reactive programming
 Category:            reactivity, FRP
 Description:
diff --git a/src/FRP/Reactive/Behavior.hs b/src/FRP/Reactive/Behavior.hs
--- a/src/FRP/Reactive/Behavior.hs
+++ b/src/FRP/Reactive/Behavior.hs
@@ -96,9 +96,10 @@
 b `switcher` eb = beh (unb b `R.switcher` (unb <$> eb))
 
 -- | Snapshots a behavior whenever an event occurs and combines the values
--- using the combining function passed.
+-- using the combining function passed.  Take careful note of the order of
+-- arguments and results.
 -- 
--- > snapshotWith :: (a -> b -> c) -> Event a -> Behavior b -> Event c
+-- > snapshotWith :: (a -> b -> c) -> Behavior b -> Event a -> Event c
 snapshotWith :: Ord t =>
                 (a -> b -> c)
              -> BehaviorI t b -> EventI t a -> EventI t c
@@ -114,7 +115,9 @@
 -- Figure out how to get generality.
 
 
--- | Snapshot a behavior whenever an event occurs.  See also 'snapshotWith'.
+-- | Snapshot a behavior whenever an event occurs.  See also
+-- 'snapshotWith'.  Take careful note of the order of arguments and
+-- results.
 -- 
 -- > snapshot :: Event a -> Behavior b -> Event (a,b)
 snapshot :: Ord t => BehaviorI t b -> EventI t a -> EventI t (a,b)