[ruby-list:16203] Re: RD spec.

Toshです。

> Toshさんのrdtools-0.2.1を使ってみてます。べんりです(_o_)＞Toshさん

どうもありがとうございます。(^^)

> RDでどこまで書けるか試そうと思い、また[ruby-list:16173]
> (Re: maillib? 0.5.0) のこともあったので、maillibの中から
> session.rbのドキュメントをRDで書いてみました。
> http://www.inac.co.jp/~maki/tmp/session_ja.rd
> http://www.inac.co.jp/~maki/tmp/session_ja.html

見てみました。バグや問題点の発見のためにも、使って頂けるのは本当にありが
たいです。感謝です。

> で、いくつか要望があります。
> * HTMLで言うところの<HR>が欲しい(ような気がする)
> 
> なくてもなんとかなるような気がしますが、でも何らかのセパレータ
> があった方が便利な気がします。って、元のHTMLファイル
> (doc.ja/session.html)にあったせいなんですが :-)

Toshの個人的な意見ですが、セパレータが欲しい部分には「+」程度の小さい
Headlineを置いてセクションを分けるのがよいかとおもいます。
RDの機能としては必要無いかと。
もっとも、
-----
のような行をセパレータとするようにすれば、結構自然な定義になりますが。

> * DescListElementの定義部に複数のTextElement(BlockElement)を持たせたい
> これはぜひほしいです。メソッドの名前と定義をDescListElementで
> 書く場合、現状ですと1パラグラフで全てを書かなければならなくなる
> ので繁雑になりそうです。
> # 記述の仕方をどうするかが問題になりそうですが……インデントを駆使
> # すればいけそうな気がします。

用語部分を複数行とかでなくて、定義部分を複数パラグラフですか?
う〜む、現状ではそういう場合は
: term 
  * definition 1
  * definition 2
のようにリストを入れ子にして書く、ってことなんじゃないですかねぇ、たぶん。
御指摘の通り、記述の仕方が難しいでしょうね。同じ様な理由でリストの中に
Verbatimも今のところできません。
# リストの中にVerbatimは望ましいか、って問題もありますが。
良い解決策募集したいです。

---
Tosh