Issue #7769 has been updated by pypypy567 (py _).


使用例についてはあちこち編集してるうちになんとなくこうなっただけなので強い意見は有りません。
Random#rand のもばっさり削って代わりに Kernel.#rand との違いを説明する例を増やしてもよいかもしれません。
Array#sample などの影響を受けないこととか。


例外については僕も元々はそんな感じに考えてたのですが、
青木さんのメールを読んでからは、メソッド中で明示的に raise している例外を書くというのはあくまで「面倒だったらこの程度の判断基準でいいよ」という指針だと考えています。

----------------------------------------
Bug #7769: Kernel.#rand に Rangeオブジェクト の説明がない
https://bugs.ruby-lang.org/issues/7769#change-35859

Author: znz (Kazuhiro NISHIYAMA)
Status: Open
Priority: Normal
Assignee: 
Category: doc
Target version: 
reporter: 
ruby_version: 


http://doc.ruby-lang.org/ja/1.9.3/method/Random/i/rand.html には引数に Rangeオブジェクト を指定した時の説明があるのに、
http://doc.ruby-lang.org/ja/1.9.3/method/Kernel/m/rand.html には記述がありません。


-- 
http://bugs.ruby-lang.org/

--
ML: ruby-reference-manual@m...
Info: http://QuickML.com/