--- a/Workspace.st	Tue Feb 18 18:19:00 2014 +0100
+++ b/Workspace.st	Fri Feb 21 12:23:43 2014 +0100
@@ -60,7 +60,19 @@
     (but, a lisp or prolog workspace would define its own action,
      to call for another compiler/interpreter  ...)
 
-
+    Special workspace- and doIt variables:
+        workspaces can be configured to automatically define undefined variables
+        as either workspace- or doIt variables. When encountering undefined variables,
+        the parser asks for an action, which is responded with #workspace or doIt if a
+        workspace is the requestor of a doIt. Both are implemented as value holders, and
+        the parser will generate code sending value/value: instead of normal assignment.
+        Workspace variables are kept in the Workspace class and will both persist between doIts
+        and also be visible across workspaces. They are perfect for scripting (and therefore anabled
+        by default when stx is started with one of the scripting options).
+        DoIt variables are only valid during a single doIt.
+        Be aware that when you ask from the outside via workspaceVariableAt:, you'll get a valueHolder.
+        This is by purbose, as it allows for easy monitoring and tracing of changes.
+            
     Caveat:
         in this version, Workspace does not yet support doIt in MVC setups.
         For now, simulate this by setting the doItAction, to notify the
@@ -2205,10 +2217,10 @@
 !Workspace class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libwidg/Workspace.st,v 1.314 2014-02-18 17:19:00 stefan Exp $'
+    ^ '$Header: /cvs/stx/stx/libwidg/Workspace.st,v 1.315 2014-02-21 11:23:43 cg Exp $'
 !
 
 version_CVS
-    ^ '$Header: /cvs/stx/stx/libwidg/Workspace.st,v 1.314 2014-02-18 17:19:00 stefan Exp $'
+    ^ '$Header: /cvs/stx/stx/libwidg/Workspace.st,v 1.315 2014-02-21 11:23:43 cg Exp $'
 ! !