リンク切れになっていた参照の記法ミスとタイポを修正

[Watson1978]

概要

リンク切れになっている参照のうち、原因が記法ミスとタイポに限られるものを直しました。
18 ファイル・32 箇所です。参照先が実在することは DB で確認しています。

見つけ方

rake statichtml:4.0 で静的 HTML を生成し、出力された href のうち生成物に
対応するページが無いものを集めました。読者から見て 404 になるリンクです。

参照先が存在しなくても bitclust は compileerror にせず、存在しない URL への
リンクを黙って生成するため、lint も DB 生成も通ってしまいます。

内訳

メソッドを [c:] で参照していたもの (24 箇所)

[c:OpenSSL::X509::Extension#oid] のようにメソッドをクラス参照で書いており、
[m:...] が正しい記法です。openssl / irb / psych / rexml / drb / csv /
net-imap の各ライブラリと doc/news/2_7_0.md にありました。

定数を [c:] で参照していたもの (6 箇所)

[c:OpenSSL::PKCS7::TEXT] など。同じく [m:...] が正しい記法です。

末尾の ? の付け忘れ (1 箇所)

[m:String#valid_encoding] → [m:String#valid_encoding?]

定数名のタイポ (3 箇所)

[m:GetoptLong::REQUIRE_ARGUMENT] -> [m:GetoptLong::REQUIRED_ARGUMENT]
[m:Socket::AI_CANONINAME]        -> [m:Socket::AI_CANONNAME]

どちらも実機で誤記側は存在せず、正しい綴りのみ存在することを確認しました。
文脈も NO_ARGUMENT / OPTIONAL_ARGUMENT と並ぶ列挙、getaddrinfo のフラグ
指定であり、意図は明らかです。

今回含めていないもの

同じ調査で他にもリンク切れが見つかっていますが、原因が異なり判断が要るため
分けています。

• 未収録 API への参照 (例: doc/news/2_4_0.md の Net::HTTP.post は 2.4 で
  追加されたクラスメソッドの紹介で、収録されていないことが原因)
• 削除された機能への参照 (Fixnum / Bignum / Object#taint など)
• マニュアル側の定義とずれているもの (module_function かどうかの違い)
• api/_builtin/Thread.md の 2 件は、当時 Thread: native_thread_id・thread_variables・each_caller_location を追加 #3308 と同じファイルだったため外していました。
  Thread: native_thread_id・thread_variables・each_caller_location を追加 #3308 がマージされたので Thread: リンク切れと、3.1 以降で動かないサンプルコードを修正 #3320 で対応しています

検証

• rake check_format / check_blank_lines / check_indent_in_samplecode /
  check_single_space_indent
• 修正後に静的 HTML を再生成し、直した 32 箇所がすべて解決していること、
  新たに壊れたリンクが増えていないことを確認しました
  (リンク切れ 266 種 → 238 種)

🤖 Generated with Claude Code

[znz]

レビューありがとうございます。変更された 32 箇所すべてを、各エントリの定義(### def / ### const と、その直上の ## Instance Methods / ## Singleton Methods / ## Constants 見出し)と突き合わせて確認しました。いずれも実在する定義を指す正しい記法になっており、マージ可と考えます。

特に [c:...] は bitclust 側でリンク先の存在確認を一切行わず(class_link が ::→= の文字列変換をするだけ)、[c:Class.method] や [c:Class::CONST] は存在しないページへの静かなリンク切れになります。一方 [m:...] は typemark(# / . / ::)を見てインスタンス / 特異 / 定数を正しく解決します。したがって本 PR の [c:]→[m:] 置換はどれも実際のリンク切れの修正になっています。

代表的な確認:

• [m:String#valid_encoding]→[m:String#valid_encoding?](定義は ? 付き）
• [c:CSV.parse_line]→[m:CSV.parse_line](## Singleton Methods 配下。同ファイル内で既に [m:CSV.parse_line] と書かれている箇所とも一致)
• [m:GetoptLong::REQUIRE_ARGUMENT]→REQUIRED_ARGUMENT(定義・サンプルコードとも REQUIRED_ARGUMENT)
• [m:Socket::AI_CANONINAME]→AI_CANONNAME(AI_CANONINAME は全 socket 定数に存在せず、常にリンク切れだったタイポ)
• OpenSSL 系(X509::Extension#critical? ほか)・定数(PKCS7::TEXT・X509::Name::OBJECT_TYPE_TEMPLATE ほか)も、すべて対応する ### def / ### const を確認しました。

いずれも括弧内の記法・綴りの修正のみで、周囲の地の文や意味には手が入っていない点も確認しました。ありがとうございました。

🤖 Generated with Claude Code