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

File rand_srand2.patch added

とりあえず Random#rand のサンプルの部分だけ書き直してみました。
書き方はともかく内容的にはこれくらいでいいんじゃないかなーと。


以下例外について。

例のメールについて、僕は

 * 不要なら書かない方がよいが判断が面倒なら全部書いてもいいし、それすら面倒なら全部略してもいい
くらいに解釈しました。
足りないよりは余分な方がましですが理想的には必要十分を目指すべきと思います。


> ただし、積極的に今書いてあるArgumentError やTypeErrorは消す必要は無い。

というわけで不要と判断出来たら積極的に消してもよいと思っています。


> もし、本当にいらないならbitclust等のツールで@raise
> を識別してArgumentErrorやTypeErrorをHTML等の最終生成物では消すことができる。

青木さんも
> こいつらはたぶん書く必要ないと思います。
と完全な断言を避けているようにクラス名だけで機械的に判断出来る話ではないと思います。


> 私の個人的なリファレンス使用傾向だと、@paramの記述が２行以上だと全部の記述をちゃんと読まないことが多く、よって@raise
> のように独立した部分に分けて書いてあると、ちゃんと読む確率が上がるのでTypeErrorでもArgumentError
> でもあった方がうれしいですが(^^;)

分からなくもないですが、それは @raise に期待する役割ではなさそうな？
どうなんでしょう。


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

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/