db-late バッジ補正: ドキュメント追加が遅かった 56 エントリに since を明示

[znz]

refs #3269

メソッド単位 since バッジは「本番 DB 17 版でエントリが最初に現れる版」から自動計算されるため、ドキュメントの追加が実際のメソッド導入より遅かったエントリは、バッジが実際より遅い版を表示してしまいます(#3274 の tools/method-versions/mismatch-report.md で db-late に分類した 92 件)。凍結 DB(2.7.0 以前)は再生成されないため、#3256 と同方式の明示 {: since=} 属性で 56 エントリ(28 ファイル・78 行) を補正します。

内訳

• {: since=""}(バッジ非表示)= 41 エントリ — 昔から public な継承メソッドとして呼び出せたもの(Array#all?/none?/one?/max/min/minmax、Range#to_a/min/max ほか、各クラスの inspect/==/eql?/hash/=~/=== 系)。バージョンバッジ算出の誤りを {: since=""} / {: since="X"} で補正する #3256 で collect/any? に適用したのと同じ方針です。
• 実値付き = 15 エントリ — クラス自体の導入がゲートになるもの(Complex/Rational 系 = 1.9.1、Enumerator::Lazy#with_index = 2.0.0、Process::Waiter#pid = 2.2.0 など)や機能新設(Rational#positive?/negative? = 2.3.0、Struct#deconstruct/deconstruct_keys = 2.7.0、Thread#set_trace_func = 1.9.2、Object#initialize_dup = 1.9.2 など)。

全 56 件、旧版 Ruby(all-ruby の各版バイナリ)で「その版で実際に呼び出せる/前の版では呼び出せない」ことを確認済みです。

トリアージで「修正不要」と確定した 8 件(doc 変更なし)

• private 継承の誤検出(現行バッジが既に正しい): Binding#local_variables・Fiber#raise・NameError#local_variables
• 既存の #@since ゲートの意図した帰結: ENV.dup(3.1)・Range#reverse_each(3.3)
• undef の見落とし: Complex#<=> は 2.6 まで undef されていて呼び出せない(実機確認)ため現行バッジ 2.7.0 が正当
• 属性だけでは正確に直せない(要検討): KeyError.new({: since=} はメソッド名単位で全オーバーロードに共有されるため、基本形 1.9.1 とキーワード形 2.6.0 を切り分けられない)・Object#initialize_clone(freeze: キーワードが 3.0 新設)

この経緯と、explicit-wrong 4 件(ARGF.class の print 系)が誤検出だった訂正を tools/method-versions/mismatch-report.md に正誤表として追記しています(compare.rb の既知の限界=可視性無視・undef 非検出なども記録)。

確認

• rake check_blank_lines / check_indent_in_samplecode 通過
• 全挿入行が署名行(### def)直後にあることを機械検証
• 代表ファイルの bitclust ミニ描画で、属性行が可視テキストに漏れず描画が master と同一であることを確認
• open 中の他 PR(Set の inspect 表示を Ruby 4.0 の Set[...] 形式に対応 #3275/ObjectSpace::WeakMap: 4.0 での位置づけ変更を反映し #[] に例を追加 #3276 および同時に出す 3 本)と相互にクリーンマージできることを git merge で確認済み

🤖 Generated with Claude Code

[znz]

メソッドごとの since/until はメソッド名のみを基準として引数の違いは考慮しないという方針だったはずなので、 KeyError.new についてはそのままで良いはずです。
(キーワード引数化などの signature ごとでわけるなら、対応が必要なメソッドは他にもたくさんありそうです。)

[znz]

レビューありがとうございます。3 件ともご指摘のとおりでした。継承で常時呼べることを重視して {: since=""} にしていましたが、いずれもメソッド固有のバージョン事情があり、バッジまたは本文で明示すべきでした。実機(all-ruby)で確認して修正しました(コミット bc3bc4e)。

• ENV.freeze: 実測でも 2.6 では例外なし・2.7 から TypeError でした(2.7 で自クラス定義が追加)。{: since="2.7.0"} に直し、「Ruby 2.7 で追加された挙動。それより前は例外を発生させなかった」旨を本文にも追記しました。
• ENV.clone: 2.6〜3.1 は動作し、**3.2 から複製自体ができず TypeError(Cannot clone ENV)**でした。本文に「3.2 からは複製自体ができなくなり TypeError が発生する」を追記しました(バッジは since="" のまま)。
• NilClass#=~: 2.6 で追加でした([m:Object#=~] が 2.6 で deprecated・3.2 で削除、その代替として nil のマッチを警告なしで行うために追加)。{: since="2.6.0"} に直し、その経緯を本文にも追記しました。

なお同じ =~ でも [m:Symbol#=~] は 1.9.3 からの実マッチメソッド(Integer | nil を返す)で性質が異なり、since=""(バッジなし)のままにしています。

bitclust のミニ描画で 3 件のバッジ・本文が正しく描画されること、rake check_blank_lines 等の lint 通過も確認済みです。

🤖 Generated with Claude Code

[znz]

追加のレビューありがとうございます。すべて反映しました(コミット 2902f88)。

インラインの 2 件

• ENV.clone の返り値: ご提案どおり #@since 3.2 で分岐し、3.2 以降は -> ()(常に TypeError で返り値なし)、それ以前は -> object としました。
• NilClass#=~ の [m:Object#=~]: ご指摘のとおり [m:Object#=~] は #@until 3.2 で 3.2 以降には存在せず、NilClass のページは 3.2 以降でも出るためリンク切れになります。本文の 2 箇所を平文(`Object#=~`)に変更しました。

KeyError.new の方針(review より)

「since はメソッド名のみを基準・引数の違いは考慮しない」方針、承知しました。それに従い、needs-human としていた 2 件を素直にバッジ付与に変更しました:

• KeyError.new: {: since="1.9.1"}(KeyError クラスの導入版)。receiver: / key: のキーワード版が 2.6 なのは方針どおりバッジには反映していません。
• Object#initialize_clone: 同じ理由で保留していましたが、同方針で {: since="1.9.2"}(導入版)を付与しました(freeze: キーワードが 3.0 なのは反映せず)。姉妹の initialize_dup と揃います。

(おっしゃるとおり、signature ごとに分けるとキーワード引数化などで対応対象が大量になるので、名前基準が妥当だと思います。)

bitclust ミニ描画で、KeyError.new=「since Ruby 1.9.1」・initialize_clone=「since Ruby 1.9.2」・ENV.clone の 3.2 の -> () 分岐・NilClass#=~ の Object#=~ 非リンク化・compileerror ゼロ を確認済みです。

🤖 Generated with Claude Code