diff --git a/docs/keyd.scdoc b/docs/keyd.scdoc
index 553f370..363b8c3 100644
--- a/docs/keyd.scdoc
+++ b/docs/keyd.scdoc
@@ -932,12 +932,13 @@ _will thus produce A-tab instead of M-\\_.
 ## Example 6
 
 ```
-	# Tapping both shift keys will activate capslock.
+	# Briefly holding down both shift keys will toggle capslock.
 
 	[shift]
 
-	leftshift = capslock
-	rightshift = capslock
+	# Without a delay, you might accidentally toggle capslock as you type.
+	leftshift = timeout(leftshift, 1000, capslock)
+	rightshift = timeout(rightshift, 1000, capslock)
 ```
 
 ## Example 7