Regenerate manual/api with the full build-version scope [1.8.7, 4.2)#3042
Merged
Conversation
The manual/ tree was originally converted from refm/ with the scope [3.0, 4.2), so entities and libraries that only exist before Ruby 3.0 were left out and pre-3.0 structural gates were resolved away. This salvages that information by regenerating manual/api with bin/rrd2md --graph --scope 1.8.7,4.2 (rurema/bitclust support: gated library membership lists, kept whole-file gates, partial-H1-gate handling), so every version the Rakefile can build (1.8.7 onward) is covered by the Markdown tree and refm/ is no longer needed to rebuild old documentation. - 17 added files: libraries and classes removed before 3.0 (e2mmap, thwait, sync's error classes, shell/error, SortedSet, old logger classes, ubygems gates, ...) - 150 modified: pre-3.0 version gates reinstated and front matter since/until added; the 24 entities whose library membership varies by version (thread's core classes, old rdoc) now carry gated library membership lists - 12 deleted: split files whose H1 gate does not wrap their content (syslog constants modules, renamed net/http response classes, Timeout::Error) move back inline into their parent files so pre-rename versions still parse them in context Verified with the bitclust salvage tooling: roundtrip 1166/1166 byte-exact, tree parity clean, bridge parse equivalence at 1.8.7/1.9.3/2.0.0/2.7.0/3.4/4.1, native parse equivalent at 3.4 and 1.9.3 (one known doc edge below 2.7), and 3.0+ output identical to the previous tree. Native database builds for 3.4 and 2.0.0 smoke-tested from this tree; 1.8.7 keeps refm's pre-existing cgi/util parse error identically. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概要
旧版サルベージです。manual/ は移行時にスコープ [3.0, 4.2) で変換したため、3.0 より前にしか存在しないライブラリ/クラスと 3.0 未満の構造ゲートが落ちていました。bitclust のサルベージ対応（companion PR: ゲート付き library 所属ほか）を使い、
bin/rrd2md --graph --scope 1.8.7,4.2で manual/api を再生成します。これで Rakefile が持つ全ビルド対象版（1.8.7〜）を Markdown ツリーだけで再ビルド可能になり、refm/ 削除（Stage B）の前提が整います。変更の内訳（180 ファイル）
manual/doc・manual/capi はスコープ非依存のため変更なし（再生成で不変を確認済み）。
検証
マージ順
bitclust の companion PR を先にマージしてください。この PR の CI は bitclust master がゲート付き所属を理解するまで失敗します（旧 MarkdownTree は
library:のリスト形式を読めず thread 系クラスの所属が落ちるため）。🤖 Generated with Claude Code