doc: misc cleanups and additions for RDoc

This is also our website, so we need to document the new
Cool.io-based concurrency options for users and point
existing Rev* users to it.

1 files changed, 5 insertions, 2 deletions

diff --git a/lib/rainbows/fiber.rb b/lib/rainbows/fiber.rb
index ed01147..3dc97c3 100644
--- a/lib/rainbows/fiber.rb
+++ b/lib/rainbows/fiber.rb
@@ -1,14 +1,16 @@
 # -*- encoding: binary -*-
-# :enddoc:
+# :stopdoc:
 begin
   require 'fiber'
 rescue LoadError
   defined?(NeverBlock) or raise
 end
+# :startdoc:
 
-# core module for all things that use Fibers in Rainbows!
+# core namespace for all things that use Fibers in \Rainbows!
 module Rainbows::Fiber
 
+  # :stopdoc:
   # blocked readers (key: fileno, value: Rainbows::Fiber::IO object)
   RD = []
 
@@ -17,6 +19,7 @@ module Rainbows::Fiber
 
   # sleeping fibers go here (key: Fiber object, value: wakeup time)
   ZZ = {}
+  # :startdoc:
 
   # puts the current Fiber into uninterruptible sleep for at least
   # +seconds+.  Unlike Kernel#sleep, this it is not possible to sleep