docs(toolchain): toolchain internals doc (en+zh) + remove .xpkg-exports.json reader#197
Merged
Merged
Conversation
…rts.json reader New contributor-facing document describing the toolchain machinery end to end — resolution, the link model, the unified post-install fixup pipeline (trigger semantics, marker fingerprinting, the never-patch-in-place and ownership invariants), the human-facing cfg, the hermetic link check — and how to extend it: new toolchains, new CPU architectures, and the embedded/bare-metal outlook (no-loader / self-contained-sysroot toolchains map onto existing CLibMode semantics). Also removes mcpp's reader for the persisted .xpkg-exports.json (the xlings-side writer is reverted in openxlings/xlings#352): its only consumer was this resolver, while the triple map + glob fallbacks already cover every real payload — the entire 0.0.83 verification matrix ran green on xlings 0.4.62, which never had the file. The decision is recorded in the new doc (§3). Loader resolution behavior is unchanged for every existing payload. No release needed: doc + dead-code removal only.
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.
Two follow-ups from the #196 review discussion:
New doc:
docs/08-toolchain-internals.md(+ zh mirror) — contributor-facing description of the toolchain machinery: resolution pipeline, the link model, the unified post-install fixup pipeline (ask-every-build/act-once trigger semantics, content-fingerprinted marker, never-patch-in-place + ownership invariants), the human-facing cfg, the hermetic link check, and extension guides for new toolchains, new CPU architectures, and embedded/bare-metal toolchains (which map onto existingCLibModesemantics: no loader + self-contained sysroot).Remove the
.xpkg-exports.jsonreader fromlinkmodel's loader resolution (companion to Revert "feat(xim): persist declared xpkg exports (#351)" openxlings/xlings#352 which reverts the writer): its only consumer was this resolver, while the per-arch triple map + glob fallbacks already cover every real payload — the entire 0.0.83 verification matrix (PR CI, hermetic container, fresh installs on 3 platforms + 6 distro containers) ran green on xlings 0.4.62, which never had this file. A general-purpose package manager shouldn't carry a mechanism whose sole reader is one downstream tool; the decision is recorded in the new doc §3. Behavior is unchanged for every existing payload.No version bump — docs + dead-code removal only.