From: Yusuke ENDOH Date: 2009-11-12T21:33:23+09:00 Subject: [ruby-dev:39676] Re: [Bug:trunk] Enumerator.new {|y| y << 1 << 2 << 3 } 遠藤です。 2009年11月12日21:17 NARUSE, Yui : >> 2009年11月12日0:38 Akinori MUSHA : >>>>> それはそれとして、ドキュメントは必要でしょうねぇ。 >>>> Enumerator::Yielder と Enumerator::Generator は全部 nodoc だったので、 >>>> あわせて適当に書いてみました。これもコミットしようと思います。 >>> Yielder/Generator という組合せによる実装は実験的なもので、特に >>> 後者は外部に公開する必要がないので敢えて伏せていました。公開仕様に >>> すると制約になるので、需要が生じるまでは非公開の方がいいのではない >>> でしょうか。 >> >> ああ、やっぱりそういう意図なんですよね。そういうことならドキュメントは >> コミットしないでおきます。 > > experimenal ならばその旨のドキュメントは入れておいた方がいいのではないでしょうか。 「何やら yield メソッドと << メソッドが定義されたオブジェクトが渡される」 という仕様は fix されているけれど、それが Yielder のインスタンスであると いうことは (現在の実装がそうなってるだけで) 保証していない、という意味だ と思います。あってますよね？ > knu さん そういう場合どこに doc を書くべきかなんですが、[ruby-dev:39672] のように すればよさそうです。 -- Yusuke ENDOH