doc: stop recommending Fiber* stuff

Too much NIH and too fragile.

2 files changed, 12 insertions, 2 deletions

diff --git a/lib/rainbows/fiber/io/pipe.rb b/lib/rainbows/fiber/io/pipe.rb
index c7ae508..59114d7 100644
--- a/lib/rainbows/fiber/io/pipe.rb
+++ b/lib/rainbows/fiber/io/pipe.rb
@@ -1,7 +1,12 @@
 # -*- encoding: binary -*-
 # A Fiber-aware Pipe class, gives users the illusion of a synchronous
 # interface that yields away from the current Fiber whenever
-# the underlying descriptor is blocked on reads or write
+# the underlying descriptor is blocked on reads or write.
+#
+# It's not recommended to use any of this in your applications
+# unless you're willing to accept breakage.  Most of this is very
+# difficult-to-use, fragile and we don't have much time to devote to
+# supporting these in the future.
 class Rainbows::Fiber::IO::Pipe < Kgio::Pipe
   include Rainbows::Fiber::IO::Methods
 end
diff --git a/lib/rainbows/fiber/io/socket.rb b/lib/rainbows/fiber/io/socket.rb
index 61c451d..2b4df12 100644
--- a/lib/rainbows/fiber/io/socket.rb
+++ b/lib/rainbows/fiber/io/socket.rb
@@ -1,7 +1,12 @@
 # -*- encoding: binary -*-
 # A Fiber-aware Socket class, gives users the illusion of a synchronous
 # interface that yields away from the current Fiber whenever
-# the underlying descriptor is blocked on reads or write
+# the underlying descriptor is blocked on reads or write.
+#
+# It's not recommended to use any of this in your applications
+# unless you're willing to accept breakage.  Most of this is very
+# difficult-to-use, fragile and we don't have much time to devote to
+# supporting these in the future.
 class Rainbows::Fiber::IO::Socket < Kgio::Socket
   include Rainbows::Fiber::IO::Methods
 end