readonly? で IO::Buffer.for のブロックの有無による違いを説明する

ruby/ruby#18062 (マージ済み) で IO::Buffer#readonly? の rdoc が明確化された
のに合わせる。従来の記述は「IO::Buffer.for で作ったバッファ」とだけ書いており、
ブロックを渡した場合に読み取り専用にならない点が抜けていた。

実機 (3.1.6 / 3.2.11 / 3.4.10 / 4.0.6 で同じ) の挙動:

  IO::Buffer.for("test").readonly?                        # => true
  IO::Buffer.for("test") { |buf| buf.readonly? }          # => false
  IO::Buffer.for("test".freeze) { |buf| buf.readonly? }   # => true
  IO::Buffer.new(4).readonly?                             # => false

ブロックなしの場合は内部で作った文字列の複製を元にするため、元の文字列が
freeze されていなくても常に読み取り専用になる。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: Watson1978

manual/api/_builtin/IO__Buffer.md

@@ -448,12 +448,23 @@ p IO::Buffer.new(4).external?      # => false
 #@# set_value / for を収録したらリンクに戻す
 読み取り専用のバッファは、`IO::Buffer#set_value` や [m:IO::Buffer#set_string]、
 [m:IO::Buffer#copy] などで変更できません。
-`IO::Buffer.for` で作ったバッファや、読み取り専用のファイルから作ったバッファが
-これにあたります。
+
+`IO::Buffer.for` にブロックを渡さずに作ったバッファは、元の文字列が freeze
+されているかどうかによらず、常に読み取り専用になります。内部で作った文字列の
+複製をバッファの元として使うためです。
+ブロックを渡した場合は元の文字列のメモリを直接参照するため、
+その文字列が freeze されている場合にだけ読み取り専用になります。
+読み取り専用のファイルから作ったバッファも読み取り専用です。
 
 ```ruby
-p IO::Buffer.for("test").readonly? # => true
-p IO::Buffer.new(4).readonly?      # => false
+# ブロックを渡さない場合は、元の文字列が freeze されていなくても読み取り専用
+p IO::Buffer.for("test").readonly?                  # => true
+
+# ブロックを渡した場合は元の文字列に従う
+p IO::Buffer.for("test") { |buf| buf.readonly? }    # => false
+p IO::Buffer.for("test".freeze) { |buf| buf.readonly? } # => true
+
+p IO::Buffer.new(4).readonly?                       # => false
 ```
 
 ### def mapped? -> bool