RD でも書いてみようか 【第 3 回】 RD as a ruby document format

--- Thread.exclusive { ... }
    ブロックから出るまで、どれかひとつのスレッドしか動かないようにする。こ
    れは「このメソッドを実行したスレッドしか動かさない」というふうに勘違い
    しやすいですが、違います。ブロックの中で Thread.pass を呼んで、メソッ
    ド切り替えを起こしてみると良く分かります。
       require 'thread'
       3.times {|i| Thread.start(i) {|i| loop { puts i; sleep 1 } } }
       Thread.exclusive do
          loop do
             puts 3
             sleep 1
             Thread.pass # <---------- (A)
          end
       end
    (A)の Thread.pass で、上で作った三つのスレッドのどれか((-たぶん2-))に
    実行が切り替わりますが、今度はそのスレッドから他のスレッドに処理が移ら
    なくなるのが観測できるでしょう。

    教訓: Thread.exclusive と Thread.pass を混ぜると痛い目に遭う

--- Hash#fetch(key1) {|key2| ... }
    引数のあるメソッドの例。ブロック引数も書けます

--- Date.new([y [, m [, d [, s]]]])
    引数が省略できます。全部省略したら今日の日付になるようです

--- Enumerable#inject([k]) {|i, j| ... }
    ((|j|)) に self の各要素を次々に代入しながら、ブロックを逐次的に
    実行します。((|i|)) には直前に実行したときのブロックの値が代入さ
    れます。一番最後のブロックが実行された後のブロックの値がこのメソッ
    ドの戻り値になります。

    引数 ((|k|)) が与えられれば、最初のブロック実行のときにこれが
    ((|i|)) に代入されます。そうでない場合は self の最初の要素が
    ((|i|)) に、その次の要素が ((|j|)) に代入された状態からスタートし
    て、以下順に繰り返されます。

    例: Ruby ホームページの中で何回 "ruby" が書かれているか調べる
       require 'open-uri'
       URI("http://www.ruby-lang.org/en/").read.inject(0) {|r, i|
          r + (/ruby/i.match(i) ? 1  : 0)
       }

 --- Zlib::GZipWriter#finish
     gzip ファイルの終わりに到達したことにして、ストリームを閉じる。
     このメソッドを呼ぶ前に、 GZipWriter がラップしている IO オブ
     ジェクトに対して (({close})) が呼ばれると、gzipファイルが壊れ
     ます。 (({close})) するまえに必ず (({finish})) してください

インストールするには ((%sudo ruby setup.rb%)) としてください