From: Tadayoshi Funaba <tadf@...>
Date: 2000-08-26T23:36:04+09:00
Subject: [ruby-list:24540] Re: RubyDocumentationProject(仮)

ふなばです。

At 2000-08-26T18:55:58+0900 (2451782.91387JD),
JCA02266@nifty.ne.jp (Koji Arai) wrote:

JCA02266> 今のところ、見出しの中で ((<>)) は使えないようになってたはず
JCA02266> なのでとりあえず大丈夫ですが。別の記号でもよいですよ。(なん
JCA02266> となく記号増やすのは躊躇してしまいますが)

RD では、単独でラベルをつける、というのはなかったんですよね。これまで
のような自動的にラベルをつける機能って要らないような気がしてしまったの
ですが、やっぱり要りますか。RD そのものは原始的な機能を提供して、組み
合せは御自由にという考えです (そのほうが応用が効きそうなので)。個別に
機能を提供したらどうなるか検討してみるのも面白いのでは。

JCA02266> でも、この案でも、衝突しない参照の作成のために、クラス名を
JCA02266> 「見えない、見せないはできない」のですがそれでもよいです？

え? なんで? 

たとえば、文書の構造から Date のインスタンスメソッド upto だと判るのな
ら、ただ upto とあれば十分な気がします。もちろん、ラベルは Date#upto 
をつかうことになると思います。
# もちろん、見せたい人は見せる選択ができてもいいんですが。

; upto(max){|date| ...}
RD に展開 -->
: ((>Date#upto|upto<))(((|max|))){|((|date|))| ...}
HTML に変換 -->
<a name="Date_sharp_upto">upto(<var>max</var>){|<var>date</var>| ...}</a>

ってそういうことでないのかな。

# ところで、考えたら、これは単なる記述の方便じゃないんだから
# =class File < IO
# として、展開すればいいってもんじゃないか。この形式を採用すれば別だけど。

ふなば ただよし