高尾です。

> 返り値のための @return みたいなのは、導入しないのでしょうか。
> あんまり多くすると繁雑になってしまいますが。

返り値の説明があったほうが、リファレンスマニュアルとして親切だと思いま
す。というわけで@returnの導入に賛成です。

ただ、メソッドの処理結果によって、返り値がnilだったり多値(配列)だったり
と、いくつかのパターンを取るメソッドがあると思いますが、どのように記述
するのでしょうかね。

例えば、以下のように複数の@returnを記述することになるのでしょうかね。

  @return nil
  取得できなかった場合はnilを返します。
  
  @return a, b, c 
  取得できた場合はaとbとcを返します。
  aは...で、bは...で、cは...です。

それとも、以下のように@returnを一つ記述し、説明で全パターンを網羅するこ
とになりますかね。

  @return
  取得できなかった場合はnilを返します。
  取得できた場合はaとbとcを返します。
  aは...で、bは...で、cは...です。

---
高尾 宏治 - TAKAO Kouji <kouji@n...>
株式会社ネットワーク応用通信研究所 <http://www.netlab.jp/>

--
ML: ruby-reference-manual@m...
使い方: http://QuickML.com/