From 06de4af18d1ba3b28e49e9d8f700df4eca36e635 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Wed, 25 Nov 2009 12:14:21 -0800 Subject: Documentation updates for new concurrency models --- lib/rainbows/fiber_pool.rb | 6 ++++-- lib/rainbows/fiber_spawn.rb | 5 +++-- lib/rainbows/rev_thread_spawn.rb | 3 ++- 3 files changed, 9 insertions(+), 5 deletions(-) (limited to 'lib') diff --git a/lib/rainbows/fiber_pool.rb b/lib/rainbows/fiber_pool.rb index 8c408b9..ff693fa 100644 --- a/lib/rainbows/fiber_pool.rb +++ b/lib/rainbows/fiber_pool.rb @@ -7,9 +7,11 @@ module Rainbows # A Fiber-based concurrency model for Ruby 1.9. This uses a pool of # Fibers to handle client IO to run the application and the root Fiber # for scheduling and connection acceptance. The pool size is equal to - # the number of +worker_connections+. This model supports a streaming + # the number of +worker_connections+. Compared to the ThreadPool + # model, Fibers are very cheap in terms of memory usage so you can + # have more active connections. This model supports a streaming # "rack.input" with lightweight concurrency. Applications are - # strongly advised to wrap slow all IO objects (sockets, pipes) using + # strongly advised to wrap all slow IO objects (sockets, pipes) using # the Rainbows::Fiber::IO class whenever possible. module FiberPool diff --git a/lib/rainbows/fiber_spawn.rb b/lib/rainbows/fiber_spawn.rb index d1c1ec0..969c05b 100644 --- a/lib/rainbows/fiber_spawn.rb +++ b/lib/rainbows/fiber_spawn.rb @@ -4,9 +4,10 @@ require 'rainbows/fiber' module Rainbows # Simple Fiber-based concurrency model for 1.9. This spawns a new - # Fiber for every client connection. This exports a streaming + # 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 slow all IO objects (sockets, pipes) using + # strongly advised to wrap all slow IO objects (sockets, pipes) using # the Rainbows::Fiber::IO class whenever possible. module FiberSpawn diff --git a/lib/rainbows/rev_thread_spawn.rb b/lib/rainbows/rev_thread_spawn.rb index 1dc4d0d..b6c5eca 100644 --- a/lib/rainbows/rev_thread_spawn.rb +++ b/lib/rainbows/rev_thread_spawn.rb @@ -1,7 +1,8 @@ # -*- encoding: binary -*- require 'rainbows/rev' -warn "Rainbows::RevThreadSpawn is extremely experimental" +RUBY_VERSION =~ %r{\A1\.8} and + warn "Rainbows::RevThreadSpawn does not work well under Ruby 1.8" module Rainbows -- cgit v1.2.3-24-ge0c7