diff --git a/twander.1 b/twander.1
index 7b77c07..4288be6 100644
--- a/twander.1
+++ b/twander.1
@@ -2720,6 +2720,33 @@
 \fCtwander\fP treats them like a User-Defined Variable as
 described below.
 
+.IP \(bu 4
+A Directory Shortcut Statement may make reference to
+user-defined, environment, and execution variables.
+
+.ft C \" courier
+.nf
+    ~ = [$HOME]
+
+    DIRSC1 = [~]/Desktop       # User-defined variable
+    DIRSC3 = [$HOME]           # Environment variable
+    DIRSC5 = [`echo "/tmp"`]   # Execution variable (but silly)
+.fi
+.ft \" revert
+
+If you use one of these forms, it's up to you to make sure that
+when when the variables are dereferenced (substituted), the
+resulting string is the name of a directory.  Be careful, you may not spot
+a definition that is
+.B not
+a directory right away.  Variables are dereferenced at runtime not at
+the time the Configuration File is read in.  Therefore, Directory
+Shorcut assignments with variable references in them are shown
+literally in the Shortcut Menu.  \fCtwander\fP cannot know what
+the value of the variable will be until you actually press
+the relevant shortcut key.
+
+
 .SS Wildcard Statements
 
 As discussed above, \fCtwander\fP provides powerful regular
@@ -5216,4 +5243,4 @@
 .ft \" revert
 
 .SH DOCUMENT REVISION INFORMATION
-$Id: twander.1,v 1.146 2007/01/02 20:17:15 tundra Exp $
\ No newline at end of file
+$Id: twander.1,v 1.147 2007/01/08 08:04:23 tundra Exp $