1 files changed, 19 insertions, 0 deletions
diff --git a/redshift.1 b/redshift.1
index 3cd9184..c9667aa 100644
--- a/redshift.1
+++ b/redshift.1
@@ -148,6 +148,25 @@ location\-provider=manual
 lat=55.7
 lon=12.6
 .fi
+.SH HOOKS
+Executable files (e.g. scripts) placed in `~/.config/redshift/hooks'
+will be run when a certain event happens. The first parameter to the
+script indicates the event and further parameters may indicate
+more details about the event. The event `period-changed' is indicated
+when the period changes (`night', `daytime', `transition'). The second
+parameter is the old period and the third is the new period. The event
+is also signaled when Redshift starts up with the old period set to
+`none'.
+
+A simple script to handle these events can be written like this:
+.IP
+.nf
+#!/bin/sh
+case \fB$1\fR in
+    \fBperiod-changed\fR)
+        exec notify-send "Redshift" "Period changed to \fB$3\fR"
+esac
+.fi
 .SH AUTHOR
 .B redshift
 was written by Jon Lund Steffensen <jonlst@gmail.com>.