青木です。

  In mail "[ruby-reference-manual:283] Re: requireするライブラリの存在について"
  sheepman <sheepman@s...> wrote:

> こんばんは、sheepman です。
> 
> 確認ですが、リファレンスには実際に require されているファイル名を
> なんでもかんでもを書くのではなくて、「独立したライブラリとして使用されることが
> 期待されているもの(例えば、 webrick/cgi など)」でなおかつ「同じライブラリ内のファイル」
> が require されていたら、リファレンスにも require を書くということですよね。

前者はそのとおりです。

後者は、結果としてそうなることが多い (ほとんどである) と思いますが、
必須条件とは考えていません。具体的にどういうライブラリがあるかは
すぐには浮かびませんが、Ruby はだいたい予想の上を行ってくれるので、
きっと例があると思います。

そうか、例えば resolv-replace と resolv なんかは非常に関係が密
なので、require 書いてもいいかとは思いますね。これが別のライブラリ
と言えるかどうかは微妙ですが。


> だから、webrick/httpstatus みたいに独立したライブラリとして使われないものは、
> 実際のコードで require されていたとしても、リファレンスには書かないんですよね。

そのとおりです。
独立していないライブラリは、ライブラリとして登録したり require したり
せず、#@include で結合するのが望ましいと考えています。

あ、そうか。誤解のあるところがわかりました。岩月さんのメールに返事を
したときに想定していたのは、「まだファイルは存在していないけど、いずれ
登録されるはずのライブラリ」のことです。例えば webrick/cgi.rd をまだ
書いてないけど、これはそのうち書くから先に書いておこう、ということです。
将来にわたって決して書かれることのないライブラリ (webrick/httpstatus
とか) にも require を書くという意味ではありません。


> ついでに、リファレンスに require を書く目的も教えていただけると幸いです。

ユーザが、あるライブラリを require したときに使えるクラスの一覧を出す
ためです。例えば require 'tk' と書いたら tk ライブラリの一連のクラス
はすべて使えるようになるわけですが、src/tk.rd 自体にはその一部しか書
いてありません。つまり、tk 以下のライブラリのページを全部見ないと使える
クラスがわからないわけです。それでは不便なので、require を書いといて、
自動的にクラス一覧を計算できるようにしよう、ということです。

--
青木峰郎

--
ML: ruby-reference-manual@m...
使い方: http://QuickML.com/