--- a/SharedQueue.st	Wed Sep 07 09:34:15 2016 +0200
+++ b/SharedQueue.st	Wed Sep 07 13:58:52 2016 +0200
@@ -49,12 +49,23 @@
     a writer will be blocked when attempting to write into a full queue.
     For nonBlocking read, use #isEmpty; for nonBlocking write, use #isFull.
 
+    Be warned:
+        if the reader process wants to add elements to the sharedqueue in its
+        read-loop, the reader may block, if the queue is full.
+        The reason is that the sharedQueues size is fixed, and any writer is blocked
+        if the queue is full.
+        For this situations, please use an UnlimitedSharedQueue, which grows in this
+        particular situation.
+        
     See samples in doc/coding.
 
     [author:]
         Claus Gittinger
 
     [see also:]
+        SharedCollection
+        UnlimitedSharedQueue
+        Queue
         Semaphore
         Process
         CodingExamples::SharedQueueExamples