From: Wakou Aoyama Date: 1999-10-31T01:55:29+09:00 Subject: [ruby-list:18158] Re: I want rd2info (or rd2texi). 青山です。 On Sat, 30 Oct 1999 14:16:28 +0900, Koji Arai wrote: > やっぱり、以下だとソースを見たときにスクリプトとド > キュメントの両方の見通しが悪くなるのかなぁ？ > > > =begin > > === ESCAPE HTML &"<> > > CGI::escapeHTML("string") > > =end > > def CGI::escapeHTML(string) > > ... > > end 私はこのタイプの方がドキュメント、ソースを見比べてお互いの問題点を発見 しやすくなるので好きですが、欠点はやはりありまして、ドキュメントだけを 取り出した時に、それが読みやすい順番になるようにソースも順番を入れ換え る必要があるという事ですね。 そこで、cgi.rb ではあのように、ある程度まとめたドキュメント部分と定義 の近くに記述するのとを使い分けています。(って、そういう話の流れで良かっ たでしょうか？ あまりきちんと読んでいなかったのですが) -- 青山 和光 Wakou Aoyama