From 6ea50dd6866a7b4eda5134cb2c8980710285e127 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Tue, 26 Apr 2011 14:04:26 -0700 Subject: doc: stop recommending Fiber* stuff Too much NIH and too fragile. --- lib/rainbows/fiber/io.rb | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) (limited to 'lib/rainbows/fiber/io.rb') diff --git a/lib/rainbows/fiber/io.rb b/lib/rainbows/fiber/io.rb index da377d0..3005d96 100644 --- a/lib/rainbows/fiber/io.rb +++ b/lib/rainbows/fiber/io.rb @@ -1,13 +1,18 @@ # -*- encoding: binary -*- -# A Fiber-aware IO class, gives users the illusion of a synchronous -# interface that yields away from the current Fiber whenever +# A \Fiber-aware IO 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 # +# 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. +# # This is a stable, legacy interface and should be preserved for all # future versions of Rainbows! However, new apps should use -# Rainbows::Fiber::IO::Socket or Rainbows::Fiber::IO::Pipe instead. - +# Rainbows::Fiber::IO::Socket or Rainbows::Fiber::IO::Pipe instead +# (or better yet, avoid any of the Rainbows::Fiber* stuff). class Rainbows::Fiber::IO attr_accessor :to_io -- cgit v1.2.3-24-ge0c7