ruby-dev

At Thu, 12 Nov 2009 21:33:23 +0900,
Yusuke ENDOH wrote:
> 
> 遠藤です。
> 
> 2009年11月12日21:17 NARUSE, Yui <naruse@airemix.jp>:
> >> 2009年11月12日0:38 Akinori MUSHA <knu@idaemons.org>:
> >>>>> それはそれとして、ドキュメントは必要でしょうねぇ。
> >>>> Enumerator::Yielder と Enumerator::Generator は全部 nodoc だったので、
> >>>> あわせて適当に書いてみました。これもコミットしようと思います。
> >>> Yielder/Generator という組合せによる実装は実験的なもので、特に
> >>> 後者は外部に公開する必要がないので敢えて伏せていました。公開仕様に
> >>> すると制約になるので、需要が生じるまでは非公開の方がいいのではない
> >>> でしょうか。
> >>
> >> ああ、やっぱりそういう意図なんですよね。そういうことならドキュメントは
> >> コミットしないでおきます。
> >
> > experimenal ならばその旨のドキュメントは入れておいた方がいいのではないでしょうか。
> 
> 「何やら yield メソッドと << メソッドが定義されたオブジェクトが渡される」
> という仕様は fix されているけれど、それが Yielder のインスタンスであると
> いうことは (現在の実装がそうなってるだけで) 保証していない、という意味だ
> と思います。あってますよね？ > knu さん

　はい、その通りです。

> そういう場合どこに doc を書くべきかなんですが、[ruby-dev:39672] のように
> すればよさそうです。

　遠藤さんは匿名クラス化を提案されていますが、 :nodoc: あるいは
「このクラスは実装都合だから依存禁止」と書くのでは甘いですかね。
SEGV等の危険ではなく互換性の仮定を避けるための匿名化というのは、
プログラマを信用しないという点でRuby的ではなく、もし慣習化すると
ライブラリを書く上で面倒な制約になってしまうのではないかと危惧
します。


P.S.
Redmineが私の投稿を拾ってくれないのはPGP署名のせいかな？
署名なしで送ってみます。

-- 
Akinori MUSHA / http://akinori.org/

Thread

Prev Next

In This Thread

Prev Next

[#39604] [Bug #2323] "Z".."Z".succが空 — Hiro Asari <redmine@...>

[#39606] [Feature:trunk] Dir instance methods for relative path — Nobuyoshi Nakada <nobu@...>

[#39626] [Bug #2327] String#upto で beg が非英数の時破壊的変更がその後に影響する — Yui NARUSE <redmine@...>

[#39629] [Bug #2327](Closed) String#upto で beg が非英数の時破壊的変更がその後に影響する — Yui NARUSE <redmine@...>

[#39632] [Feature #2328] malloc_limit の肥大化を防ぎたい — _ wanabe <redmine@...>

[#39635] [Bug #2331] Kernel#system の第一引数が書き換えられる — Kimura Yoshihiro <redmine@...>

[#39636] [Feature #2328] malloc_limit の肥大化を防ぎたい — _ wanabe <redmine@...>

[#39637] [Bug #2334] 大きなFixnumを値にもつHash#hashが呼び出しごとに変わる — Wataru Kimura <redmine@...>

[#39639] [Bug #2335] Windows 環境下の Dir.glob で Segmentation Fault が発生する — Kenta Murata <redmine@...>

[#39641] [Feature #2328] malloc_limit の肥大化を防ぎたい — _ wanabe <redmine@...>

[#39642] [Bug #2338] 大きなFixnumを値にもつHash#hashが呼び出しごとに変わる — Yuki Sonoda <redmine@...>

[#39646] [Bug #2331](Closed) Kernel#system の第一引数が書き換えられる — Usaku NAKAMURA <redmine@...>

[#39650] [Feature #2341] CGIMultipartTest#_read のモードをバイナリモードに — _ wanabe <redmine@...>

[#39653] [Bug #2342] bootstraptest/test_thread.rb がまれに失敗する — _ wanabe <redmine@...>

[#39655] RVALUEからはみ出した領域の大きさに関して — Masanori OTA <ota.m.ac@...>

[#39657] [bug:trunk] Invalid read by ./ruby -v — Tanaka Akira <akr@...>

[#39659] stack area in blocking region with -O0 — Tanaka Akira <akr@...>

[#39660] [Bug:trunk] Enumerator.new {|y| y << 1 << 2 << 3 } — Yusuke ENDOH <mame@...>

[#39662] [Bug #825](Assigned) Gem::Installer#generate_windows_script の引数の順番が他と一致しない — Yui NARUSE <redmine@...>

[#39669] メンテナ確認プロセス終了。メンテナ募集 — "Yugui (Yuki Sonoda)" <yugui@...>

[#39671] [Feature:trunk] hide the internal of anonymous Enumerator — Yusuke ENDOH <mame@...>

[#39679] [Feature #2060] DLをCからRubyに変換する事を勧めます — Aaron Patterson <redmine@...>

[#39680] [Feature #2060] DLをCからRubyに変換する事を勧めます — Yui NARUSE <redmine@...>

[#39681] [Feature #2060](Closed) DLをCからRubyに変換する事を勧めます — Aaron Patterson <redmine@...>

[#39684] [bug:trunk] configure: WARNING: unrecognized options: --with-opt-dir — Tanaka Akira <akr@...>

[#39685] [Feature #2366] private constant — Yusuke Endoh <redmine@...>

[#39687] [Bug:trunk] memory leak of Class#dup — Yusuke ENDOH <mame@...>

[#39690] [Bug #2368] URI.regexp にマッチする文字列が URI.parse できないことがある — Kouhei Yanagita <redmine@...>

[#39691] [Bug #2368](Rejected) URI.regexp にマッチする文字列が URI.parse できないことがある — Yui NARUSE <redmine@...>

[#39692] [Bug #2369] ENV's strange behavior on WinXP — _ wanabe <redmine@...>

[#39693] String#split の第1引数の省略時の値 — "KISHIMOTO, Makoto" <ksmakoto@...4u.or.jp>

[#39694] [Bug #2368] URI.regexp にマッチする文字列が URI.parse できないことがある — Kouhei Yanagita <redmine@...>

[#39696] [Feature #2372] read_all() with buffering — _ wanabe <redmine@...>

[#39697] [Bug #2368] URI.regexp にマッチする文字列が URI.parse できないことがある — Yui NARUSE <redmine@...>

[#39703] [Bug #2373] URI.parse は hier-part が空である URI をパースできない — Kouhei Yanagita <redmine@...>

[#39704] [Bug #2374] URI.regexp('http') が 'http://' にマッチする — Kouhei Yanagita <redmine@...>

[#39709] [Bug #2381] Math.gammaの挙動がx86_64とia64で異なる — Mitsuhiro TAKANO <redmine@...>

[#39714] Net::FTP で upload の resume ができない — Tomoyuki Chikanaga <chikanag@...>

[#39716] ruby 1.9.1p339がtest-allでsegv — akira yamada / やまだあきら <akira@...>

[#39720] hidden objectって? — keiju@... (Keiju ISHITSUKA)

[#39722] NKF の MIME エンコード・デコード — "KISHIMOTO, Makoto" <ksmakoto@...4u.or.jp>

[#39723] [Bug:1.8] Re: Ruby:r25230 (ruby_1_8, trunk): * marshal.c (struct {dump,load}_arg): manage with dfree, instead — Urabe Shyouhei <shyouhei@...>

[#39725] [Bug #2369] ENV's strange behavior on WinXP — Usaku NAKAMURA <redmine@...>

[#39739] [Bug #2369] ENV's strange behavior on WinXP — Usaku NAKAMURA <redmine@...>

[#39740] [Bug #2369] ENV's strange behavior on WinXP — Usaku NAKAMURA <redmine@...>

[#39741] [Bug #2387] test/mkmf/base.rb は RbConfig::CONFIG['cppflags'] が nil のとき例外で止まる — Kenta Murata <redmine@...>

[#39742] [Bug #2388] test-all 中に popen で ruby.exe が落ちる — Kenta Murata <redmine@...>

[#39743] String::gsubにおけるinvalid byte sequenceの検出について — TAKEGAWA Hiroshi <takegawa@...>

[#39744] [Bug #2390] Marshal.dump pass a hidden object — _ wanabe <redmine@...>

[#39751] build error if PTHREAD_STACK_MIN is a function call — Yusuke ENDOH <mame@...>

[#39755] RbConfig.rubybin — Tanaka Akira <akr@...>

[#39757] [Bug #2393] NoMethodError's message change in second time — _ wanabe <redmine@...>

[#39760] [Bug #2395] 可視性の変更による alias されたメソッドの無効化 — _ wanabe <redmine@...>

[#39763] [Bug #2369] ENV's strange behavior on WinXP — Usaku NAKAMURA <redmine@...>

[#39767] [Bug:trunk] cannot call public'ed method via public_method — Yusuke ENDOH <mame@...>

[#39768] [Bug:trunk] race condition of /#{ foo }/o — Yusuke ENDOH <mame@...>

[#39769] require 'dbi' でうまくゆかないときがあります。 — Nobuyuki Inaba <nobuyuki.inaba@...>

[#39771] [Bug #2401] Array splat bug: a=[1,2]; p [*a] #=> [] — Akinori MUSHA <redmine@...>

[#39772] [Bug #2402] super in instance_eval — Shugo Maeda <redmine@...>

[#39789] [Bug #2388] test-all 中に popen で ruby.exe が落ちる — Usaku NAKAMURA <redmine@...>

[#39790] [Bug #2387](Closed) test/mkmf/base.rb は RbConfig::CONFIG['cppflags'] が nil のとき例外で止まる — Nobuyoshi Nakada <redmine@...>

[#39792] [Bug #2405] Test::Unit.runの条件判定が逆? — Sho Hashimoto <redmine@...>

[#39793] Re: [ruby-cvs:32310] Ruby:r25092 (trunk): * win32/win32.c, include/ruby/win32.h (rb_w32_access): new function to — "Yugui (Yuki Sonoda)" <yugui@...>

[#39794] [Bug #2338](Assigned) 大きなFixnumを値にもつHash#hashが呼び出しごとに変わる — Yui NARUSE <redmine@...>

[#39796] バグ? ブロック引数で to_ary が呼ばれる必要のない場面で呼ばれる — keiju@... (Keiju ISHITSUKA)

[#39798] [Bug #2407] numeric literal without digits — Shyouhei Urabe <redmine@...>

[#39810] [Backport #2338](Closed) 大きなFixnumを値にもつHash#hashが呼び出しごとに変わる — Yuki Sonoda <redmine@...>

[ruby-dev:39677] Re: [Bug:trunk] Enumerator.new {|y| y << 1 << 2 << 3 }

Thread

In This Thread

[#39769] require 'dbi'　でうまくゆかないときがあります。 — Nobuyuki Inaba <nobuyuki.inaba@...>