IO::Buffer: 定数 10 個と例外クラス 5 個を追加

PR rurema#3278 のレビューで「未収録の定数・例外クラスへの参照はリンク切れになる
ので早めの回で追加すると良い」と助言いただいた分。

定数 (10):
  EXTERNAL / INTERNAL / SHARED / LOCKED / PRIVATE / READONLY と
  LITTLE_ENDIAN / BIG_ENDIAN / HOST_ENDIAN / NETWORK_ENDIAN

例外クラス (5):
  AccessError / AllocationError / InvalidatedError / LockedError / MaskError

実機で登場バージョンを確認したところ、SHARED と MaskError のみ 3.2 で追加
されていた (他は 3.1 から存在) ため、その 2 つだけ #@SInCE 3.2 で分岐した。

例外の発生条件は io_buffer.c の rb_raise 箇所を確認したうえで記述し、
再現できるもの (AccessError / LockedError / MaskError) は実機で確認した例を
添えた。AllocationError と InvalidatedError は意図的に再現させることが難しい
ため、例は付けず条件の説明のみとした。

あわせて set_string の raise 記述から AccessError への参照を張った。

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

Author: Watson1978

manual/api/_builtin/IO__Buffer.md

@@ -57,6 +57,60 @@ OS のページサイズをバイト数で表した値です。
 バッファを仮想メモリ機構(Unix では匿名 mmap、Windows では VirtualAlloc)で
 確保することを表すフラグです。[m:IO::Buffer.new] の flags に指定します。
 
+### const EXTERNAL -> Integer
+
+バッファが外部(external)のメモリ領域、すなわち [c:String] など他のオブジェクトが
+所有するメモリ領域を指していることを表すフラグです。
+
+### const INTERNAL -> Integer
+
+バッファが内部(internal)のメモリ領域、すなわち Ruby が直接確保したメモリ領域を
+指していることを表すフラグです。
+
+#@since 3.2
+### const SHARED -> Integer
+
+バッファが他のプロセスと共有されるメモリ領域を指していることを表すフラグです。
+#@end
+
+### const LOCKED -> Integer
+
+バッファがロックされていることを表すフラグです。
+
+ロックされている間はバッファの解放やリサイズができません。
+[m:IO::Buffer#locked] を参照してください。
+
+### const PRIVATE -> Integer
+
+バッファがコピーオンライトで確保されていることを表すフラグです。
+
+このバッファへの変更は元のメモリ領域には反映されません。
+
+### const READONLY -> Integer
+
+バッファが読み込み専用であることを表すフラグです。
+
+このフラグが立っているバッファに書き込もうとすると
+[c:IO::Buffer::AccessError] が発生します。
+
+### const LITTLE_ENDIAN -> Integer
+### const BIG_ENDIAN -> Integer
+### const HOST_ENDIAN -> Integer
+### const NETWORK_ENDIAN -> Integer
+
+バイトオーダー(エンディアン)を表す定数です。
+
+HOST_ENDIAN は実行中の環境のバイトオーダーで、LITTLE_ENDIAN か BIG_ENDIAN の
+いずれかと同じ値になります。NETWORK_ENDIAN はネットワークバイトオーダーで、
+BIG_ENDIAN と同じ値です。
+
+```ruby
+p IO::Buffer::NETWORK_ENDIAN == IO::Buffer::BIG_ENDIAN # => true
+
+# リトルエンディアンの環境の場合
+p IO::Buffer::HOST_ENDIAN == IO::Buffer::LITTLE_ENDIAN # => true
+```
+
 ## Class Methods
 
 ### def new(size = IO::Buffer::DEFAULT_SIZE, flags = 0) -> IO::Buffer
@@ -136,6 +190,7 @@ buf.get_string(0, 99)   # ~> ArgumentError
 - **raise** `ArgumentError` -- offset と length の合計がバッファのバイト数を超える場合に発生します。
 
 - **raise** `IO::Buffer::AccessError` -- 書き込みできないバッファに対して呼び出した場合に発生します。
+             詳しくは [c:IO::Buffer::AccessError] を参照してください。
 
 ```ruby
 buf = IO::Buffer.new(8)
@@ -150,3 +205,54 @@ IO::Buffer.new(2).set_string("TOOLONG") # ~> ArgumentError
 ```
 
 - **SEE** [m:IO::Buffer#get_string]
+
+# class IO::Buffer::AccessError < RuntimeError
+
+書き込みできないバッファに書き込もうとした場合や、
+外部(external)のバッファをリサイズしようとした場合に発生します。
+
+```ruby
+buf = IO::Buffer.for("abc")
+p buf.readonly?      # => true
+buf.set_string("z")  # ~> IO::Buffer::AccessError
+```
+
+# class IO::Buffer::AllocationError < RuntimeError
+
+バッファ用のメモリ領域を確保できなかった場合に発生します。
+
+# class IO::Buffer::InvalidatedError < RuntimeError
+
+無効になったバッファを使用しようとした場合に発生します。
+
+バッファが指しているメモリ領域が既に解放されているなど、
+そのバッファがもう使用できない状態になっていることを表します。
+
+# class IO::Buffer::LockedError < RuntimeError
+
+ロックされているバッファに対して、ロック中は行えない操作をした場合に発生します。
+
+具体的には、ロック中のバッファをリサイズしようとした場合や、
+[m:IO::Buffer#transfer] で所有権を移そうとした場合、
+既にロックされているバッファを再度ロックしようとした場合などです。
+
+```ruby
+buf = IO::Buffer.new(4)
+buf.locked do |b|
+  b.resize(8)  # ~> IO::Buffer::LockedError
+end
+```
+
+#@since 3.2
+# class IO::Buffer::MaskError < ArgumentError
+
+ビット演算に渡したマスクが不正な場合に発生します。
+
+具体的には、長さ 0 のバッファをマスクに指定した場合や、
+マスクが演算対象のバッファと重なっている場合です。
+
+```ruby
+IO::Buffer.new(4) & IO::Buffer.new(0) # ~> IO::Buffer::MaskError
+```
+
+#@end