From: matz@... (Yukihiro Matsumoto)
Date: 2000-06-30T14:39:47+09:00
Subject: [ruby-list:23622] Re: readablity of RD

まつもと ゆきひろです

In message "[ruby-list:23621] Re: readablity of RD"
    on 00/06/30, TAKAHASHI Masayoshi <maki@inac.co.jp> writes:

|ちなみにこのスレッドの先頭にある私の発言 [ruby-list:23222] では、
|「RDを読みやすくするにはどうすればよいか？(特に見出し)」という
|内容になってますので、「plain text時ではそんなに読みやすくなく
|てもいいのでは。書きやすさ重要だし」ということなら、そこで話は
|終わります (^^;;

私はなんとなくそんな気分です。工夫の余地がないとは言いません
が、まさか文法の変更のようなドラスティックな話が出て来るのは
予想外でした。

|また、ひとくちにRDと言っても、
|
|  1. 単独の文書の場合 (何から何まで)
|  2. ソースの頭やおしりにある場合 (そのファイルに関すること何でも)
|  3. ソースの中にある場合 (個々のクラスやメソッドの説明)
|
|といったそれぞれの場合において、「読みやすさ」が微妙に異なるようにも
|思います。特に、3. の場合の読みやすさが一番気になっています。
|もっとも、まだメソッドリストはまだあまり試してないので、それを使うと
|マシになるのかもしれません。

1,2はそれほど問題がないのは経験から確かです。3についてどのよ
うな工夫を行うか、あるいはMethod Indexならどうだとかいう話は
ありえると思います。

|# でもクラス名までいちいち書くのがめんどくさそう……というか、
|# それが理由でメソッドにも「====」とかを使っているのでした。

クラス名は必須ではないのでは？

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