about summary refs log tree commit homepage
path: root/lib/rainbows/coolio_fiber_spawn.rb
diff options
context:
space:
mode:
Diffstat (limited to 'lib/rainbows/coolio_fiber_spawn.rb')
-rw-r--r--lib/rainbows/coolio_fiber_spawn.rb18
1 files changed, 11 insertions, 7 deletions
diff --git a/lib/rainbows/coolio_fiber_spawn.rb b/lib/rainbows/coolio_fiber_spawn.rb
index 52b3e63..7b00d58 100644
--- a/lib/rainbows/coolio_fiber_spawn.rb
+++ b/lib/rainbows/coolio_fiber_spawn.rb
@@ -1,13 +1,17 @@
 # -*- encoding: binary -*-
 require 'rainbows/fiber/coolio'
 
-# A combination of the Coolio and FiberSpawn models.  This allows Ruby
-# 1.9 Fiber-based concurrency for application processing while exposing
-# a synchronous execution model and using scalable network concurrency
-# provided by Cool.io.  A streaming "rack.input" is exposed.
-# Applications are strongly advised to wrap all slow IO objects
-# (sockets, pipes) using the Rainbows::Fiber::IO or a Cool.io-compatible
-# class whenever possible.
+# A combination of the Coolio and FiberSpawn models.
+#
+# This concurrency model is difficult to use with existing applications,
+# lacks third-party support, and is thus NOT recommended.
+#
+# This allows Ruby 1.9 Fiber-based concurrency for application
+# processing while exposing a synchronous execution model and using
+# scalable network concurrency provided by Cool.io.  A streaming
+# "rack.input" is exposed.  Applications are strongly advised to wrap
+# all slow IO objects (sockets, pipes) using the Rainbows::Fiber::IO or
+# a Cool.io-compatible class whenever possible.
 module Rainbows::CoolioFiberSpawn
 
   include Rainbows::Base