レビュー対応: IO#wait_priority を io/wait.md へ移動

wait / wait_readable / wait_writable と定義場所を揃える。実機で確認したところ
この 4 つは 3.0 / 3.1 では require "io/wait" が必要で、3.2 以降は require なしで
使える。wait_priority だけ _builtin/IO.md に #@SInCE 3.2 で置くと、兄弟と
定義場所が分かれ、since バッジも揃わない。

ただし io/wait.md は版で囲まれていないため、そのままだと 1.8.7〜2.7.0 の
ページにも出てしまう。require "io/wait" しても 2.7.8 では wait_priority が
未定義で 3.0.7 から存在するので、このエントリだけ #@SInCE 3.0 で囲んだ。

返り値の説明も wait_readable と同じ 3 ケース (バッファにあれば true、
ブロック後に可能になれば self、タイムアウトで nil) に揃えた。
io_wait_priority が rb_io_read_pending なら Qtrue、そうでなければ
io_wait_event(io, RUBY_IO_PRIORITY, timeout, 1) を返す実装と一致する。

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

Author: Watson1978

manual/api/_builtin/IO.md

@@ -2471,20 +2471,6 @@ r.read # ~> IO::TimeoutError
 
 - **SEE** [m:IO#timeout], [c:IO::TimeoutError]
 
-### def wait_priority(timeout = nil) -> bool | self | nil
-
-self が優先データを受信して読み込み可能になるまで待ちます。
-
-優先データ(緊急データ)は [m:Socket::Constants::MSG_OOB] フラグを用いて
-送受信され、通常はストリーム型のソケットに限られます。
-
-- **param** `timeout` -- タイムアウトを秒単位の数値で指定します。
-             nil を指定すると読み込み可能になるまで待ち続けます。
-- **return** -- 読み込み可能になった場合は真を、timeout で指定した時間が経過した
-        場合は nil を返します。
-
-- **SEE** [m:IO#wait_readable], [m:IO#wait_writable]
-
 #@end
 
 ## Constants

manual/api/io/wait.md

@@ -69,3 +69,26 @@ timeout を指定した場合は、指定秒数経過するまでブロックし
 - **param** `timeout` -- タイムアウトまでの秒数を指定します。
 
 - **SEE** [m:IO#wait_readable]
+
+#@since 3.0
+### def wait_priority(timeout = nil) -> bool | self | nil
+
+self が優先データを受信して読み込み可能になるまでブロックし、
+読み込み可能になったら真値を返します。
+
+優先データ(緊急データ)は [m:Socket::Constants::MSG_OOB] フラグを用いて
+送受信され、通常はストリーム型のソケットに限られます。
+
+より詳しくは、一度ブロックしてから読み込み可能になった場合には
+self を返します。
+内部のバッファにデータがある場合には
+ブロックせずに true を返します。
+
+timeout を指定した場合は、指定秒数経過するまでブロックし、タ
+イムアウトした場合は nil を返します。
+
+- **param** `timeout` -- タイムアウトまでの秒数を指定します。
+             nil を指定すると読み込み可能になるまで待ち続けます。
+
+- **SEE** [m:IO#wait_readable], [m:IO#wait_writable]
+#@end