バージョンバッジ算出の誤りを {: since=""} / {: since="X"} で補正する

[znz]

概要

バージョンバッジの誤算出 — メソッド自体は古くからあるのにリファレンスへの記載が後から追加され、記載時期が初出として表示されるケース(rurema/bitclust#132 で報告の Array#collect「Ruby 2.5.0 から」問題)— を、rurema/bitclust#274 で解禁された {: since=""}(不明の明示=バッジ非表示)と {: since="X"}(真の版の明示)で一括補正します。3 コミット構成です。

1. lock 更新: bitclust を a1f45b3({: since=""} を「明示的に不明」= バッジ非表示として解禁する bitclust#274 マージ後の master)へ
2. 要約ドキュメント: 属性表に since="" の行と空値の説明を追記
3. 一括補正: 7 ファイル・95 属性行(59 エントリ)
   • since="" × 41 エントリ: ruby v1_8_7 のソースで定義を確認し、かつ現在の本番 DB で誤ったバッジが算出されているもの(例: Array#collect/map = array.c:3803/3805 で現表示「Ruby 2.5.0 から」。Enumerable 経由で 1.8 から呼べた Array#any? も C 再定義の 2.2 ではなくこちらに分類)
   • since="1.9.1" × 11: v1_9_1_0 で確認(Dir.exists?・Symbol#match・Enumerator::Yielder#<</#yield・ARGF の encoding 系ほか。現表示 1.9.3〜2.5.0 を真値へ)
   • since="1.9.3" × 7: ARGF の write 系(1.9.1/1.9.2 には無いことを確認。現表示 2.0.0)
   • 意図的に対象外: Array#filter(2.6 追加)・Fixnum#magnitude(1.9 系)・ARGF.class#inspect(2.0 の alias 追加)= 同じエントリ内でも算出値が正しい別名には付けず、名前単位で補正
   • 付けずに済ませたもの: String#each_byte/each_char/each_line/lines・Hash#merge!・Range#include?・GC.stress=・$stderr・Fixnum#abs は、1.8.7 の凍結 DB に別名グループの一員として名前が記録されている(例: $stderr は $deferr エントリの names=deferr,stderr)ため算出が既に floor = バッジ非表示と判定しており、明示は冗長

検証

• 手法: 全 10 凍結版 DB のエントリ初出一覧 × ruby ソース tarball(v1_8_7〜v2_7_0 + v1_9_1_0/v1_9_2_0)の突き合わせで候補 976 件 → ソースで確証が取れたもののみ採用(静的 grep で確認できないものは保守的に見送り)。さらに本番 DB の算出値(since_by_name)と全件突き合わせ、実際に誤バッジが表示されているものだけに絞り込み(ファイル一覧ベースの初出判定では別名レベルの存在が見えず、既に floor 判定で非表示のものが 9 エントリ混じっていたため除外)
• ビルド: 本ブランチの manual/api 全体を新パーサで DB 化し ParseError 0。エントリ実測で collect=,map=(空)・select= のみ(filter= 無し)・to_s= のみ・match=1.9.1・$stderr 空などを確認
• bitclust methodsince を適用しても明示値が上書きされないこと、描画で Array#collect = バッジ 0・Symbol#match = 「Ruby 1.9.1 から」になることを確認

refs rurema/bitclust#132

🤖 Generated with Claude Code