--- a/FileText.st	Thu Jun 02 13:35:26 1994 +0200
+++ b/FileText.st	Thu Jun 02 13:36:39 1994 +0200
@@ -23,14 +23,23 @@
 COPYRIGHT (c) 1989 by Claus Gittinger
               All Rights Reserved
 
-FileText represents the contents of a text-file;
-in core only the offsets of the text-lines are stored in an array
-to save space; the at: method fetches the line from the file.
-Individual textlines may be replaced by strings.
-the underlying file is NOT updated in this case
+$Header: /cvs/stx/stx/libbasic2/FileText.st,v 1.5 1994-06-02 11:35:33 claus Exp $
+'!
+
+!FileText class methodsFor:'documentation'!
 
-$Header: /cvs/stx/stx/libbasic2/FileText.st,v 1.4 1993-10-13 02:12:06 claus Exp $
-'!
+documentation
+"
+    FileText represents the contents of a text-file;
+    in core only the offsets of the text-lines are stored in an array
+    to save space; the at: method fetches the line from the file.
+    Individual textlines may be replaced by strings.
+    the underlying file is NOT updated in this case.
+    Care should be taken, if the underlying file is rewritten -
+    you have to manually update/flush the pointers.
+    Never rewrite the file using the data from a FileText.
+"
+! !
 
 !FileText class methodsFor:'instance creation'!