From: Tadayoshi Funaba <tadf@...>
Date: 2000-08-26T17:52:26+09:00
Subject: [ruby-list:24525] Re: RubyDocumentationProject(仮)

ふなばです (RD を理解しつつあるかも)。

At 2000-08-26T02:37:49+0900 (2451782.23459JD),
toshirok@yb3.so-net.ne.jp (Toshiro Kuwabara) wrote:

toshirok> 結局はRDなんて各人が好きに書けばいいんじゃないですか。別にHTMLみたい
toshirok> に厳密な文章構造を定義しているってわけでもないですし。

そうですね、RD そのものはそういうものかな、と思います。ただ、メソッド
リストは主張があるように見えるんですよね。それが気になってたんですね。

toshirok> だから、クラス名を省略するのは別にしちゃいけないわけじゃない
toshirok> けど、クラス名を省略すると場合によってはラベルが衝突します。

クラス名を書かないで済めば、それにこしたことはないんですけど (半分あき
らめたらしい)、むしろ、見たくない、見せたくない、んです。RD の都合とし
て必要なことは解りますが、表にでてほしくないです。

toshirok> ただし、きちんとそれをやるにはメソッドの書式を解析する必要が
toshirok> あるので、標準的な書き方でないMethodListを書くと間違ったHTML
toshirok> になってしまうかも。

間違えてしまうのなら、決った書きかたで書け、といったほうが親切かも。そ
うしないと、僕のようなのは解らなくなります。

toshirok> # 俺のメール、半分くらいまで読んで嫌になる人続出と予想。

でも、議論はどんどんやったほうがいいと思います。

ふなば ただよし