[ruby-list:23614] Re: readablity of RD

まつもと ゆきひろです

In message "[ruby-list:23613] Re: readablity of RD"
    on 00/06/30, Toshiro Kuwabara <[e-mail]> writes:

|う〜ん、でもRDtoolのパーサにこっそり入れておいても余計な混乱生む
|だけって気もしますし。かと言って、パーサ2つメンテするだけの余裕も
|なし。

呼ぶでしょうね。ですから、「もうひとつのフォーマット」が決まっ
てToshさんがそっちの方が良いと言うことでしたら、RDtoolはfork 
させて新しいフォーマットのパーザの面倒を見ていただいても構い
ません。私がメンテナになるなり、別に募集するなりするでしょう。

ただし、新しいフォーマットのことはRDとは呼ばないでくださいね。
私は(最近不評な ^^;;;)このフォーマットを使って、かれこれ4年
以上公私に渡って何百ページもの原稿を書いてますし、いまさら変
更されても困ります。昨日決まったフォーマットじゃないんで。

また、これだけ文章を書いた期間で

|Globalな構造をどれだけ速く把握できるか、と言うのはドキュメント
|のメンテナにとってかなり重要ではないですか？

と指摘されているようなGlobalな構造を把握するのに支障があった
ことは一度もありません。Emacsのsearchは多用してるけど。

 grep ^= text.txt

で目次が作れるのもありがたい。

|僕がいまいちわからないのは、
|
|  == Title
|  === Sub Title
|
|の様な形式が「terse(って辞書ひくまでわかりませんでしたが、"簡潔"で
|いいですよね？)」であって、
|
|  %%%% Title %%%%
|  ==== Sub Title ====
|
|が「terseでない」という感覚ですね。僕には大差ないように思えるのですが。

(本文でないものを)タイプする量が多いか少ないかってのは、私に
とってはかなり重要です。あと、4つ以上の数を数えるのもイヤ。
# 1,2,3の次は「たくさん」な人なので。

|でもパラグラフやリストよりGlobalで目立つべき見出し要素がパラグラフに埋
|もれて目立たないのもおかしな話では？

「目立たない」の基準が違うんですかね。私、見出しを見落として
困ったことないんで。

|「読むだけの人ならHTMLにでもInfoにでも好きな形式に変換すればそれで済む。
|いやでもソースを読まないといけなくなるのは結局書いている/メンテしてい
|る本人で、その人が楽できるようなフォーマットは読みやすくないといけない」
|っていうのが、僕のRD観です。

コンセプトは分かるんですけど、私にとっては現状で見出しの目立
ち方は十分ですし、これで十分読みやすいです。=begin/=endで(た
とえばメソッド単位で)細かく区切るとうっとうしいってのは認め
ますけど。

                                まつもと ゆきひろ /:|}