高橋征義です。

rubikitch <rubikitch / ruby-lang.org>さん：
> どもども、読んでくれてありがとう。

いえいえ。
# でも、欲を言えばURI固定の方がうれしかったり。

> こんなんじゃダメ？
> begin と end の組がうざいかも・・・
> 
> =begin
> = 大見出し
> あいうえお
> かきくけこ
> =end ############################################################
> =begin
> = 大見出しその2
> ここだよ〜〜〜〜〜〜
> =end

うーん、でも、まさに「begin と end の組がうざい」というのがあると
思います。つまり、

   ・見出しと「=begin」「=end」のマークアップがそっくり

であるのが見出しを目立たなくさせる要因の一つじゃないかな、と。

これはクラスやメソッド中などに細かくRDを入れるスタイルに顕著で、例えば

# RDtool-0.6.3より
-----------------------------------------------------------------
      end # catch
    end # apply_to_Include
  end # RDVisitor

=begin
== module AutoLabel
this module provide automatical labeling feature to Visitors.
=end  
  module AutoLabel

=begin
  --- AutoLabel#prepare_labels(tree[, prefix])
        initialize method. call it before calling (({((<AutoLabel#refer>))}))
        ((|tree|)) is (({RDTree})), and ((|prefix|)) is a (({String})) which
-----------------------------------------------------------------

こういうのをぱっと見ても、RD的にAutoLabelの見出しに気づきにくいのです。

# あ、どこからどこまでがコメントなのか分かりにくいというのもあるか。
# なお、自分で書く時はRDは前か後ろにまとめて書きます。

高橋征義 (TAKAHASHI Masayoshi)       Email:maki / inac.co.jp