From: TAKAHASHI Masayoshi <maki@...>
Date: 1999-08-18T19:52:01+09:00
Subject: [ruby-list:16205] Re: RD spec.

高橋征義です。

Toshiro Kuwabara <toshirok@yb3.so-net.ne.jp>さん：
> 見てみました。バグや問題点の発見のためにも、使って頂けるのは本当にありが
> たいです。感謝です。

いやいや、rd2htmlを書き直そうとしてはまった苦い記憶もあったり……。

> Toshの個人的な意見ですが、セパレータが欲しい部分には「+」程度の小さい
> Headlineを置いてセクションを分けるのがよいかとおもいます。
> RDの機能としては必要無いかと。

や、Rubyのマニュアルとかを見てみると、
http://www.netlab.co.jp/ruby/man-1.4/socket.html
とかみたいに、クラスが複数ある場合はセパレータを入れたくなるんですよ。

でも、
http://www.netlab.co.jp/ruby/man-1.4/thread.html
みたいにセパレータなしで頑張る手もなきにしもあらず、なんですけどね。

# ページの下につける<HR>をどうするか、っていう問題もあるのですが、
# それはまた別なので。

> もっとも、
> -----
> のような行をセパレータとするようにすれば、結構自然な定義になりますが。

あ、これは私がてきとーに入れただけなので、別にこれじゃなくても
構いませんです(^^;

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

そうです。HTMLで言うところの、DDの方です。
ある程度メソッドの定義には詳しいことも書きたくなると思う(実際に
書かれているものもある)ので、TextElement一つではちょっと手狭です。
maillibで言うなら、


: start( *args )
  @socket に ProtocolSocket を、@proto に @proto_type で指定したソケット
  オブジェクトを生成し、プロトコルが開始したら private メソッド do_start を
  よびだします。また、すでにログイン中のときはなにもせずに false をかえします。

  do_startではプロトコル特有の開始処理を行ないます。

を、

<dt>start( *args )
<dd>
@socket に ProtocolSocket を、@proto に @proto_type で指定したソケット
オブジェクトを生成し、プロトコルが開始したら private メソッド do_start を
よびだします。また、すでにログイン中のときはなにもせずに false をかえします。
<p>
do_startではプロトコル特有の開始処理を行ないます。
</dd>

のように解釈してほしい、と。

> う〜む、現状ではそういう場合は
> : term 
>   * definition 1
>   * definition 2
> のようにリストを入れ子にして書く、ってことなんじゃないですかねぇ、たぶん。

これはちょっと……。
そうするよりは、いっそのことDescListElementをあきらめて、


  ==== start( *args )
  @socket に ProtocolSocket を、@proto に @proto_type で指定したソケット
  オブジェクトを生成し、プロトコルが開始したら private メソッド do_start を
  よびだします。また、すでにログイン中のときはなにもせずに false をかえします。

  do_startではプロトコル特有の開始処理を行ないます。


のように、HeadlineとふつうのTextElementで書いたほうがいいかなとも
思います。どうしたものか。

> 良い解決策募集したいです。

もうちょっと考えをまとめてみます(_o_)

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