From: Toshiro Kuwabara Date: 2000-06-30T00:06:01+09:00 Subject: [ruby-list:23613] Re: readablity of RD Toshです。 In message "[ruby-list:23604] Re: readablity of RD" on 00/06/29, Yukihiro Matsumoto writes: >|>%%%%%%%% ******** ======== -------- >|> >|>こんな感じとか。 >| >|ふ〜む、話しているとだんだんよさげに思えて来るのですよね。(^^;; >|でもまつもとさんのほうから鶴の一声が入っちゃったしなぁ、とか。 > >いや、RDより「書きやすい・読みやすい」フォーマットが出て来ちゃ >ダメとはいいませんよ。それはRDではないというだけです。 う〜ん、でもRDtoolのパーサにこっそり入れておいても余計な混乱生む だけって気もしますし。かと言って、パーサ2つメンテするだけの余裕も なし。 >それに、私はterseなのが好きなので > >|%%%% Title %%%%% >|**** Title ***** > >というのは受け入れがたいです。もしかして「読みにくい」って人 >はRDのterseさが御嫌いなのではないでしょうか。 僕がいまいちわからないのは、 == Title === Sub Title の様な形式が「terse(って辞書ひくまでわかりませんでしたが、"簡潔"で いいですよね？)」であって、 %%%% Title %%%% ==== Sub Title ==== が「terseでない」という感覚ですね。僕には大差ないように思えるのですが。 >私はsetextあんまり好きじゃないです。RDより「読みやすい」だろ >うとは思うけど、「書きやすくない」と思います。3以上の数を気 >にしないといけないのが私には一番つらい。それにRD(ソース)のレ >ベルで指示が本文より目立つのは本末転倒でしょう。 でもパラグラフやリストよりGlobalで目立つべき見出し要素がパラグラフに埋 もれて目立たないのもおかしな話では？ 「目立つ見出し」の提案は、別に「指示(書式となる記号列)」を目立たせるた めでなくて「見出しと言う要素」を目立たせる必要がある、って意味ではない ですか？ そういう理由で「もっとも」なのです。僕には。 In message "[ruby-list:23602] Re: readablity of RD" on 00/06/29, Yukihiro Matsumoto writes: >「もっとも」なんですかねえ。 >メソッド毎に=begin/=endでくくるとごちゃごちゃするってのは確 >かなんですが、そもそもそういう使い方での読みやすさってのはあ >んまり必要ではないと思うのです。 > >局所的にレベルが分かれば、読みやすさのためにはLaTeXなりなん >なりに変換することで対応すれば十分のように感じています。 > >ってそういう話じゃないのかなあ。 Globalな構造をどれだけ速く把握できるか、と言うのはドキュメント のメンテナにとってかなり重要ではないですか？ スクリプトの変更に合わせてドキュメントを変更するのに、最初にする のが、「ドキュメントのどこを変更すればいいのか探すこと」ですよね。 最初にGlobalに探して、あたりをつけたところでLocalに探すというのを 意識・無意識に関わらずやっているはずです。そういう時にGlobalな探査 でもっとも頼りにしているのが見出しのような構造なのではないかと。 「読むだけの人ならHTMLにでもInfoにでも好きな形式に変換すればそれで済む。 いやでもソースを読まないといけなくなるのは結局書いている/メンテしてい る本人で、その人が楽できるようなフォーマットは読みやすくないといけない」 っていうのが、僕のRD観です。 --- Tosh Toshiro Kuwabara