From: Minero Aoki <aamine@...>
Date: 2002-03-14T17:31:20+09:00
Subject: [ruby-dev:16388] Re: ライブラリ拡大計画

あおきです。

  In mail "[ruby-dev:16352] Re: ライブラリ拡大計画"
    matz@ruby-lang.org (Yukihiro Matsumoto) wrote:

> まつもと ゆきひろです

> |  (1) ドキュメント

> RDocも可とします。
> 
> 日本語ドキュメントは標準添付しないで構わないと思ってます(冷
> たい？)。日本人以外には見てもしょうがないものだし。

すでに例が出ていますが、その方向で行くなら README.ja が存在
してはならないでしょう。また英語ドキュメントだって英語を使え
る人間にしか役に立たないはずです。

英語をデフォルトにするのは納得できますが、他の言語を積極的に
排除するのは納得できません。日本語中心がだめだというのなら、
日本語ドキュメントをなくすのではなく他の言語のドキュメントも
とりいれることで是正すべきだと思います。


> |  (2) テストスクリプト
> |
> |  現状、置く場所がない。test/ ？
> 
> これは議論の余地あり。

と言うと？ make test で全部テストが動くようにするとか？
その前に test/unit が添付されないとどうにもなんないかな。


> |  (3) .rb .so が両方あるライブラリ
> |
> |  ext/ の下に全部置くか、lib/ ext/ に分けるか。
> |  ぼくは分けるほうを推します。
> 
> ext/fooの直下に.soのソース，ext/foo/libに.rbを置きます。

微妙に納得いきませんが、妥協します。


> |* メンテナ権限の範囲はどこまでか。
> |    * 存在するファイルの修正 (……は当然 OK として)
> |    * ファイルの追加
> |    * サブディレクトリの追加
> |  たとえば net/http が結構でかいからファイルを分割したく
> |  なったとして、net/http/ を勝手に作って分割していいん
> |  でしょうか。
> 
> いいですよ。事前にひとこと言ってくださったほうがトラブルが少
> ないでしょうが，ま，さほど問題にはならないでしょう。

わかりました。当面はないですがそういうときにはここに投げるこ
とにします。


> |  また前項とも関連しますが、lib/ 以下に *.rb 以外を置いて
> |  いいんでしょうか (たとえば README とか)。
> 
> だめ，ということにしようかなあ。そのディレクトリ全体を記述す
> るREADMEだけは許すとか。

こちらも了解しました。
-------------------------------------------------------------------
青木峰郎