CSV.foreach: ブロックが与えられていない場合の挙動を加筆

[tk0miya]

https://bugs.ruby-lang.org/issues/8929 の変更以降、ブロックなしの CSV.foreach は Enumerator を返します。

irb(main):001> require 'csv'
=> true
irb(main):002> CSV.foreach('test.csv').to_a
=> []

この挙動をドキュメントに追加しました。

[znz]

ありがとうございます。
対応バージョンでは、ずっと Enumerator なのを確認しました。

% time docker run --platform linux/amd64 --rm -it ghcr.io/ruby/all-ruby env LANG=C.UTF-8 ALL_RUBY_SINCE=ruby-1.8 ./all-ruby -r csv -e 'p CSV.foreach("/dev/null").class'
ruby-1.8.0            -e:1: undefined method `foreach' for CSV:Class (NoMethodError)
                  exit 1
ruby-1.8.1            -e:1: undefined method `foreach' for CSV:Class (NoMethodError)
                  exit 1
ruby-1.8.2-preview1   CSV::IOReader
...
ruby-1.8.7-p374       CSV::IOReader
ruby-1.9.0-0          NilClass
...
ruby-1.9.2-p330       NilClass
ruby-1.9.3-preview1   Enumerator
...
ruby-3.3.0-preview1   Enumerator
ruby-3.3.0-preview2   warning: csv which will be not part of the default gems since Ruby 3.4.0
                      Enumerator
ruby-3.3.0-preview3   Enumerator
...
ruby-3.4.0-preview1   Enumerator