diff --git a/src/objective-c/RxLibrary/GRXBufferedPipe.h b/src/objective-c/RxLibrary/GRXBufferedPipe.h
index 02dc6b5fe83dfe0e0d45b79fd2dcf495c2d48f16..4147362ba42bcf11aad3c6b8c9d3a2c4e5867eec 100644
--- a/src/objective-c/RxLibrary/GRXBufferedPipe.h
+++ b/src/objective-c/RxLibrary/GRXBufferedPipe.h
@@ -45,6 +45,12 @@
 // GRXWriterStateStarted.
 // If it receives an error (via -didFinishWithError:), it will drop any buffered values and
 // propagate the error immediately.
+//
+// Beware that a pipe of this type can't prevent receiving more values when it is paused (for
+// example if used to write data to a congested network connection). Because in such situations the
+// pipe will keep buffering all data written to it, your application could run out of memory and
+// crash. If you want to react to flow control signals to prevent that, instead of using this class
+// you can implement an object that conforms to GRXWriter.
 @interface GRXBufferedPipe : NSObject<GRXWriteable, GRXWriter>
 
 // Convenience constructor.