diff --git a/alarmclock.cabal b/alarmclock.cabal
--- a/alarmclock.cabal
+++ b/alarmclock.cabal
@@ -1,5 +1,5 @@
 name:                alarmclock
-version:             0.2.0.1
+version:             0.2.0.2
 synopsis:            Wake up and perform an action at a certain time.
 description:         Wake up and perform an action at a certain time.
 homepage:            https://bitbucket.org/davecturner/alarmclock
diff --git a/src/Control/Concurrent/AlarmClock.hs b/src/Control/Concurrent/AlarmClock.hs
--- a/src/Control/Concurrent/AlarmClock.hs
+++ b/src/Control/Concurrent/AlarmClock.hs
@@ -12,10 +12,10 @@
 can itself return the time at which it should run again.
 
 To perform time-based cache expiry, create an 'AlarmClock' whose action flushes
-any stale entries from the cache and returns the next time that an entry will
-expire. If the cache contains no entries that will expire, return 'Nothing'
-from the alarm action. When expiring entries are added to the cache, call
-'setAlarm' to ensure that they will expire in a timely fashion.
+any stale entries from the cache and then calls `setAlarm` for the next time
+that an entry will expire (if there are any). When expiring entries are added
+to the cache, call 'setAlarm' to ensure that they will expire in a timely
+fashion.
 
 -}