レビュー対応: IO.* に Ruby 3.3 非推奨化の注記を追加し、例を体裁修正

IO.read/foreach/readlines/binread/write/binwrite の #@else(4.0未満)に #@SInCE 3.3 で「Ruby 3.3 から deprecated、4.0 で削除」の注記を追加(rurema#3234 と同じ形式)。実機 3.3/3.4 で該当の deprecation 警告を確認。あわせて IO.read の #@SInCE 4.0 の例を docs/SampleCodeGuideline.md に合わせ、例外は # ~> を使い p を付けない形にし、title="例" も除去した。

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

Author: Watson1978

manual/api/_builtin/IO.md

@@ -348,6 +348,9 @@ Ruby 3.x までは path の先頭が "|" のとき "|" に続くコマンドの
 この機能は Ruby 4.0 で削除され、"|" で始まる path も通常のファイル名として扱われます。
 #@else
 [m:Kernel?.open] と同様 path の先頭が "|" ならば、"|" に続くコマンドの出力を読み取ります。
+#@since 3.3
+なお、この "|" によるコマンド起動は Ruby 3.3 から deprecated であり、Ruby 4.0 で削除されました。[m:IO.popen] を使用してください。
+#@end
 #@end
 
 #@since 4.0
@@ -601,9 +604,9 @@ Ruby 3.x までは path の先頭が "|" のとき "|" に続くコマンドの
 現在は [m:IO.read]・`File.read` のいずれでも、"|" で始まる path は通常のファイル名として
 扱われます(該当するファイルが無ければ [c:Errno::ENOENT] が発生します)。
 
-```ruby title="例"
-p IO.read("|echo hello")    # => Errno::ENOENT ("|echo hello" という名前のファイルを探そうとする)
-p File.read("|echo hello")  # => Errno::ENOENT
+```ruby
+IO.read("|echo hello")    # ~> Errno::ENOENT
+File.read("|echo hello")  # ~> Errno::ENOENT
 ```
 #@else
 [m:Kernel?.open] と同様 path の先頭が "|" ならば、"|" に続くコマンドの出力を読み取ります。
@@ -615,6 +618,9 @@ path の先頭が "|" であっても普通のファイル名として扱われ
 p IO.read("|echo hello")  # => "hello\n" (コマンドを実行する)
 p File.read("|echo hello")  # => Errno::ENOENT ("|echo hello" という名前のファイルを探そうとする)
 ```
+#@since 3.3
+なお、この "|" によるコマンド起動は Ruby 3.3 から deprecated であり、Ruby 4.0 で削除されました。[m:IO.popen] を使用してください。
+#@end
 #@end
 
 #@since 4.0
@@ -675,6 +681,9 @@ Ruby 3.x までは path の先頭が "|" のとき "|" に続くコマンドの
 [m:Kernel?.open] と同様 path の先頭が "|" ならば、"|" に続くコマンドの出力を読み取ります。
 [m:IO.read] と同様、この "|コマンド名" の特別扱いはレシーバが [c:IO] である
 場合のみ有効で、`File.binread` では単なるファイル名として扱われます。
+#@since 3.3
+なお、この "|" によるコマンド起動は Ruby 3.3 から deprecated であり、Ruby 4.0 で削除されました。[m:IO.popen] を使用してください。
+#@end
 #@end
 
 length を省略するとファイルの末尾まで読み込みます。
@@ -701,6 +710,9 @@ Ruby 3.x までは path の先頭が "|" のとき "|" に続くコマンドの
 この機能は Ruby 4.0 で削除され、"|" で始まる path も通常のファイル名として扱われます。
 #@else
 [m:Kernel?.open] と同様 path の先頭が "|" ならば、"|" に続くコマンドの出力を読み取ります。
+#@since 3.3
+なお、この "|" によるコマンド起動は Ruby 3.3 から deprecated であり、Ruby 4.0 で削除されました。[m:IO.popen] を使用してください。
+#@end
 #@end
 
 テキスト読み込みメソッドとして動作します。
@@ -813,6 +825,9 @@ Ruby 3.x までは path の先頭が "|" のとき "|" に続くコマンドを
 この機能は Ruby 4.0 で削除され、"|" で始まる path も通常のファイル名として扱われます。
 #@else
 [m:Kernel?.open] と同様 path の先頭が "|" ならば、"|" に続くコマンドを実行し、コマンドの出力を標準出力に書き込みます。
+#@since 3.3
+なお、この "|" によるコマンド起動は Ruby 3.3 から deprecated であり、Ruby 4.0 で削除されました。[m:IO.popen] を使用してください。
+#@end
 #@end
 
 offset を指定するとその位置までシークします。
@@ -860,6 +875,9 @@ Ruby 3.x までは path の先頭が "|" のとき "|" に続くコマンドを
 この機能は Ruby 4.0 で削除され、"|" で始まる path も通常のファイル名として扱われます。
 #@else
 [m:Kernel?.open] と同様 path の先頭が "|" ならば、"|" に続くコマンドを実行し、コマンドの出力を標準出力に書き込みます。
+#@since 3.3
+なお、この "|" によるコマンド起動は Ruby 3.3 から deprecated であり、Ruby 4.0 で削除されました。[m:IO.popen] を使用してください。
+#@end
 #@end
 
 offset を指定するとその位置までシークします。