Add IO#set_encoding_by_bom since 2.7.0

[pocke]

#2071

Ruby 2.7 で追加された IO#set_encoding_by_bom のドキュメントを追加します。

RDoc: https://docs.ruby-lang.org/en/2.7.0/IO.html#method-i-set_encoding_by_bom

サンプルコードはRDocのものをベースに、FIle.openにブロックを渡す形にしたり、読み込んだ文字列のencodingを明示したりしています。

[pocke]

実際にはArgumentErrorが発生するようですが、RDocの方に例外クラスが明示されていなかったので、るりまでもクラスは書かないようにしています

[znz]

とりあえず良さそうだったのでマージしてしまいましたが、 UTF-8 以外 (UTF-16?) の例もあると良いかもしれません。

[pocke]

複数のエンコーディングの例があっても大して情報は増えない(BOMとエンコーディングが変わっただけで後は同じ)なので、足さなくていいかなと思っています。

一方、BOMのない非ASCII文字が含まれているテキストに対してset_encoding_by_bomを呼び出す例はあってもよいかなあと、コメントを受けて考えています