From: Toshiro Kuwabara <toshirok@...3.so-net.ne.jp>
Date: 2000-06-30T23:51:39+09:00
Subject: [ruby-list:23624] Re: readablity of RD

Toshです。

In message "[ruby-list:23618] Re: readablity of RD"
    on 00/06/30, Yasunari Momoi <momo@bug.org> writes:
>> コメントはやたら強力というか使い勝手良すぎるので、書きやすい形式の
>> コメントなんかがあったら「読みやすさを助ける使い方」も確かにできる
>> でしょうが、それ以上にエントロピー増大に貢献するのはほぼ確実と考え
>> ています。
>	...中略...
>> というわけで、コメント必要を主張する(多数派の)方はわがままなTosh
>> を説得してください。(^^;;;
>
>うーん．説得には弱い意見だということを承知で書きます ;-) が，
>『邪悪な使い方 *も* できるから，その機能は入れない』という考
>え方はあまり私の好みではありません :-)．C や perl の『便利な
>んだからいいじゃん』的発想の方が好きです．
>
>で，そのいい加減さを適度に受け継いでいる (と私は思っている)
>ruby 標準 (．．．ですよね？) documentation tool なんですから，
>便利で強力なコメント機能は入っていたほうが良いと思います．

僕にはプログラミング言語と対比するものでもないと思ってるのです。
TeXはほとんどプログラミング言語(らしい)だし、HTMLは各種ブラウザの
存在を前提にしているマークアップ言語だからコメントがあるのは理由の
あることだと思います。

でも、RDは？フォーマッタの存在を前提にしているわけではないほとんど
plain textなRDのようなマークアップ言語に、なんでフォーマッタの存在
を前提にしているコメントが必要なのでしょ？例えば、フォーマッタで
plain textに変換した時とRDそのものを見た時でドキュメントの内容が
違っているなんて変な話ではないですか？

っていうのが、個人的な意見ですが・・・

読みやすさのためにコメントが必要ってのは、コメント使って人間が注意
してやる必要がある文法がまずいはず、その時は文法の方を変えようと僕
は考えてました。文法が変更できないならそれは空論なので必要なら追加
してもいいんじゃないでしょうか。

---
Tosh
Toshiro Kuwabara