From: Motoyuki Kasahara <m-kasahr@...>
Date: 1998-11-10T19:13:23+09:00
Subject: [ruby-list:10764] Re: Ruby Document Format

笠原です。

* From: Masaki Fukushima <fukusima@goto.info.waseda.ac.jp>
* Date: Thu, 5 Nov 1998 12:24:32 +0900

> >     <!ELEMENT methods ((method|alias)+,desc*)>
> >     <!ELEMENT method (usage*,alias*,desc*)>
> > 
> > のように、単数形と複数形の両方が定義してある element が幾つかあります
> > が、これは一般的にこうするものなのでしょうか。
	: (略)
> 私の書いた rubyapi.dtd では method, methods は両方とも class_methods,
> instance_methods の中で使われる要素だと考えています。
	: (略)
> methods は 2 つ以上のメソッドに対して、まとめて desc を付けるための要
> 素です。上の例の場合、chop と chop! です。
> 
> ここで私が考慮したのは chop と chop! の 2 つは別のメソッドだが、名前も
> 機能も似ているので記述が一つにまとめられている、ということです。それを
> 表すために methods という要素を定義しました。

ああ、なるほど。
ごめんなさい。私は

     <!ELEMENT methods ((method|alias,desc*)+)>

という意味 (書き方これでいいのかな) と間違えていたのですね。
やはりも少し勉強してからでないと駄目でした。


> はたして、こんな違いまで記述する必要があるのかどうかに確信はありません。

私もどうするのが一番良いかは分かりません。(_o_)

ただ、個人的には、どちらが alias でどちらが実体かは、マニュアルにおい
てはあまり重要ではないように思います。
______________________________________________________________________
                                          笠原 基之(かさはら もとゆき)