西山和広です。

>>>>> On Fri, 15 Sep 2006 02:25:49 +0900 (JST)
>>>>> aamine@l...(Minero Aoki)  said:
> > Structはどうなりますか?
> 
> 困ってるところです。

他にクラスを返すメソッドというと、DelegateClassも
ありますが、どうでしょうか?


> > RD方式だと別々のVerbatimにしたいと思ったら
> > 間にVerbatim以外を挟むかインデントを下げて
> > いかないといけないという問題があります。
> 
> そういうドキュメントは書くべきではないので、問題だとは思いません。

そういうドキュメントというのは

  Verbatim

  別のVerbatim

というドキュメントでしょうか?
それとも

  Verbatim

  Verbatimの続き

というドキュメントでしょうか?
それとも両方でしょうか?

> また、どうしても連続して書きたければ //emlist を使えば回避でき
> ます。

連続してというのは、別々のVerbatimを連続して、でしょうか?
それとも、空行を含む連続したVerbatimでしょうか?


> > > === ハイパーリンク
> > 
> > >   * [[url:http://i.loveruby.net]]  URL http://i.loveruby.net にリンク
> > 
> > これは任意のURLにリンクできてもあんまりうれしくない、
> > RDでURL:を付け忘れると言うのを結構見たことがあった、
> > という点から、http,https,ftpぐらいを特別扱いして
> > リンクにするというので良いのではないかと思います。
> > (telnetとかgopherとかのリンクがはれてもうれしくなさそう)
> 
> 嬉しくないなら記述を長くしておいたほうがよいと思うので、
> 現状でよいでしょう。

「url:」必須の方がつけ忘れの可能性が出てうれしくないと
思います。
そもそもリファレンスマニュアルから外部リンクは
あまりつけるべきではないと言うことで長くなっているのなら、
「url:」必須のままで良いと思います。


-- 
|ZnZ(ゼット エヌ ゼット)
|西山和広(Kazuhiro NISHIYAMA)

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