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_spawn.rb | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) (limited to 'lib/rainbows/fiber_spawn.rb') diff --git a/lib/rainbows/fiber_spawn.rb b/lib/rainbows/fiber_spawn.rb index b8552d7..2c6d13d 100644 --- a/lib/rainbows/fiber_spawn.rb +++ b/lib/rainbows/fiber_spawn.rb @@ -1,12 +1,17 @@ # -*- encoding: binary -*- require 'rainbows/fiber' -# Simple Fiber-based concurrency model for 1.9. This spawns a new -# Fiber for every incoming client connection and the root Fiber for -# scheduling and connection acceptance. This exports a streaming -# "rack.input" with lightweight concurrency. Applications are -# strongly advised to wrap all slow IO objects (sockets, pipes) using -# the Rainbows::Fiber::IO class whenever possible. +# Simple Fiber-based concurrency model for 1.9. This spawns a new Fiber +# for every incoming client connection and the root Fiber for scheduling +# and connection acceptance. +# +# This concurrency model is difficult to use with existing applications, +# lacks third-party support, and is thus NOT recommended. +# +# This exports a streaming "rack.input" with lightweight concurrency. +# Applications are strongly advised to wrap all slow IO objects +# (sockets, pipes) using the Rainbows::Fiber::IO class whenever +# possible. module Rainbows::FiberSpawn include Rainbows::Fiber::Base -- cgit v1.2.3-24-ge0c7