Add Enumerator::Yielder documentation

[pocke]

Enumerator::Yielderのドキュメントを追加します。

このクラスはEnumerator.newからのみ使われるべきものなので、クラスの説明にも「直接使うものではありません」と書いています。
#1141

ただ、説明がないとEnumerator.newから使う時に迷ってしまうと思うので、ドキュメントを書くことは必要だと思っています。

また、合わせて Ruby 2.7で追加されたEnumerator::Yielder.to_procのドキュメントも書いています。 #2071
RDoc: https://docs.ruby-lang.org/en/2.7.0/Enumerator/Yielder.html#method-i-to_proc

RDocでは << と yield メソッドのドキュメントがありませんが、このドキュメントがないとEnumerator.newからどうやって使うべきか分かりづらいなと思ったので、あえて書きました。

---

ruby-jp slackの方で多少議論をしたので貼っておきます。

[pocke]

RDocの例は次のようになっています

enum = Enumerator.new { |y|
  Dir.glob("*.rb") { |file|
    File.open(file) { |f| f.each_line(&y) }
  }
}

これは実践的ではあるのですが、実行するには .rb ファイルが置かれている必要があるので、それに依存しないようにテキスト処理だけで済むようにしました