Rubyのリファレンスマニュアルはjavaのように
戻り値、引数、(関数型言語で言うところの)副作用、例外とかをきちんと書いてほしい。
特にperl/c/windows?などの関数を持ってきたものは説明が
「perlと同じだからわかるでしょ？」みたく書いてあって説明になっていないものが多い気がする。