--- a/Class.st	Wed Sep 16 21:10:46 2009 +0200
+++ b/Class.st	Wed Sep 16 21:14:02 2009 +0200
@@ -110,12 +110,26 @@
 !Class class methodsFor:'accessing-flags'!
 
 tryLocalSourceFirst
+    "if true, local source files are tried first, before a sourceCodemanager is
+     consulted. This may speed up the source access, but adds some insecurity, because
+     the sourceCodemanager is always getting the source for the classes correct version.
+     In contrast, the local file might be different from (edited in an external tool) in
+     the meantime. You have been warned - better leave it false (the sourceCodemanager will
+     fill its cache and eventually be just as fast...)"
+
     ^ TryLocalSourceFirst
 
     "Created: 24.1.1996 / 19:55:35 / cg"
 !
 
 tryLocalSourceFirst:aBoolean
+    "if true, local source files are tried first, before a sourceCodemanager is
+     consulted. This may speed up the source access, but adds some insecurity, because
+     the sourceCodemanager is always getting the source for the classes correct version.
+     In contrast, the local file might be different from (edited in an external tool) in
+     the meantime. You have been warned - better leave it false (the sourceCodemanager will
+     fill its cache and eventually be just as fast...)"
+
     TryLocalSourceFirst := aBoolean
 
     "Created: 24.1.1996 / 19:55:35 / cg"
@@ -4900,5 +4914,5 @@
 !Class class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libbasic/Class.st,v 1.542 2009-08-23 09:26:57 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libbasic/Class.st,v 1.543 2009-09-16 19:14:02 cg Exp $'
 ! !