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

ふなばです。

At 2000-08-27T15:23:26+0900 (2451783.76627JD),
toshirok@yb3.so-net.ne.jp (Toshiro Kuwabara) wrote:

toshirok> 僕はRDというのはあくまで手で書くのに都合のいい様に考えられた
toshirok> フォーマットでおおざっぱに書けば細かい所は良きにはからってく
toshirok> れる(フォーマッタとか読者とかが)ものと考えていたので、RDに細
toshirok> かい制御のための機能を詰め込んでその上にマクロ的なものをもって
toshirok> きて、書いた後でRDに変換する、なんてことをやりたいならRDは向
toshirok> いていないと思うのです。

toshirok> 定型のあるドキュメント書くのにRDの上にマクロみたいなものを作る
toshirok> のは別に構いませんけど、それに都合のいい様にRDをより低レベルな
toshirok> 機能のフォーマットにしてしまうのはなんか違うな〜、って気持です。

まるで誤解していると思います。基本的に RD は RD のままです。RD も少し
は変更しなきゃならないかもしれませんが、それは、たぶん、RD らしさを守
るためになされる、と思います。
# たぶん、メソッドリストやラベルについて。

やることは簡単に言えば、RD を歪めているかもしれない本質的でないものを 
RD から追い出すだけです。RD のなかで完結させようとすると、メソッドリス
トのように中途半端なものになるから、別に RD とともに働く仕掛を考えてみ
ましょう、ということです。

toshirok> そういうアプローチなら例えばXMLベースのフォーマットの方が現実的
toshirok> かと思います。

toshirok> それならいっそのことRDPで集めるドキュメントのフォーマットはXML
toshirok> ベースのものすれば？とか思いました。

toshirok> 別にXMLを積極的に勧めるわけではありません。RDにXMLの代わりを
toshirok> させようというなら僕は賛成できないってくらいの意味です。

まったくの見当違いです。

toshirok> # XMLという手はありだなぁ、とも実際思ってますけど。

っていうか、なんで、XML がでてきたのか、ようやく解りました。XML な解決
方法を考えてるのは、Tosh さんで、僕じゃない。言ってもいないことに反対
されてもなあ。

ふなば ただよし