2 files changed, 24 insertions, 2 deletions

diff --git a/doc/asciidoc/fluxbox-keys.txt b/doc/asciidoc/fluxbox-keys.txt
index 5c8a210..1a1548d 100644
--- a/doc/asciidoc/fluxbox-keys.txt
+++ b/doc/asciidoc/fluxbox-keys.txt
@@ -96,6 +96,10 @@ There are some special "keys" that let you bind events to non-keyboard events:::
         do anything else you like when you switch to a new workspace. See the
         *EXAMPLES* below for one idea.
 
+WARNING: Use caution with this event! For example, do NOT bind this to any
+action that changes your current workspace. If you break your fluxbox with this
+feature, you get to keep the pieces.
+
 ////////////////
 TODO: Advanced users only?
 *FocusIn* / *FocusOut*;;
diff --git a/doc/fluxbox-keys.5.in b/doc/fluxbox-keys.5.in
index 279c1f7..cfef46e 100644
--- a/doc/fluxbox-keys.5.in
+++ b/doc/fluxbox-keys.5.in
@@ -1,12 +1,12 @@
 .\"     Title: fluxbox-keys
 .\"    Author: [see the "AUTHORS" section]
 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
-.\"      Date: 03/14/2009
+.\"      Date: 05/27/2009
 .\"    Manual: Fluxbox Manual
 .\"    Source: fluxbox-keys.txt 1.1.2
 .\"  Language: English
 .\"
-.TH "FLUXBOX\-KEYS" "5" "03/14/2009" "fluxbox\-keys\&.txt 1\&.1\&.2" "Fluxbox Manual"
+.TH "FLUXBOX\-KEYS" "5" "05/27/2009" "fluxbox\-keys\&.txt 1\&.1\&.2" "Fluxbox Manual"
 .\" -----------------------------------------------------------------
 .\" * (re)Define some macros
 .\" -----------------------------------------------------------------
@@ -250,6 +250,24 @@ Fires when the workspace changes\&. This can be used to change backgrounds or do
 below for one idea\&.
 .RE
 .RE
+.if n \{\
+.sp
+.\}
+.RS 4
+.BM yellow
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
+\fBWarning\fR
+.ps -1
+.br
+.sp
+Use caution with this event! For example, do NOT bind this to any action that changes your current workspace\&. If you break your fluxbox with this feature, you get to keep the pieces\&.
+.sp .5v
+.EM yellow
+.RE
 .SH "CHAINING"
 .sp
 Key bindings can be chained in a fashion similar to Emacs key bindings using the syntax: