--- a/Stream.st	Wed May 15 18:06:19 1996 +0200
+++ b/Stream.st	Wed May 15 18:09:14 1996 +0200
@@ -39,6 +39,11 @@
     An abstract class defining common behavior for all stream-like objects.
     See concrete subclasses for more detail.
 
+    The protocol as implemented here is often only provided as a fallBack
+    for very uncommon cases. Much of it is redefined for performance.
+    (In streams which know more about their internal representation ...)
+
+
     Subclasses should (at least) implement:
         #next           (if readable)
         #nextPut:       (if writable)
@@ -47,6 +52,12 @@
         #isReadable
         #isWritable
 
+    Peekable & Positionable streams should (at least) implement:
+        #peek
+        #position
+        #position:
+
+
     [Class variables:]
         StreamErrorSignal       <Signal>        parent of all stream errors
 
@@ -1250,6 +1261,6 @@
 !Stream class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libbasic/Stream.st,v 1.41 1996-05-15 16:06:19 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libbasic/Stream.st,v 1.42 1996-05-15 16:09:14 cg Exp $'
 ! !
 Stream initialize!