@@ -81,9 +81,13 @@ each mouse click and false otherwise.
8181since : Time -> Signal a -> Signal Bool
8282since = Native.Time.since
8383
84−{-| Add a timestamp to any signal. Timestamps increase monotonically. Each
85−timestamp is related to a specfic event, so `Mouse.x` and `Mouse.y` will always
86−have the same timestamp because they both rely on the same underlying event.
84+{-| Add a timestamp to any signal. Timestamps increase monotonically. When you
85+create `(timestamp Mouse.x)`, an initial timestamp is produced. The timestamp
86+updates whenever `Mouse.x` updates.
87+
88+Timestamp updates are tied to individual events, so
89+`(timestamp Mouse.x)` and `(timestamp Mouse.y)` will always have the same
90+timestamp because they rely on the same underlying event (`Mouse.position`).
8791-}
8892timestamp : Signal a -> Signal (Time, a)
8993timestamp = Native.Time.timestamp