docs: one ranked TODO.md, and a home for the ld370/as370 reference material - #105
Merged
Conversation
…al a home Two working notes on the ld370 and as370 divergences held three kinds of content at once: open defects, settled history, and reference material about IFOX00 and the linkage editor. Neither was ever committed, so none of it was visible to anyone else, and the parts fixed months ago were still described as open. Split by owner. Defects that are still live became issues #99-#104, each with a reproducer and a code citation; the WX-before-ER one is measured on the host, not derived from the reference. Reference material moved to docs/ld370-iewl-divergences.md and as370/docs/ifox-option-parity.md, which cite routines and line numbers rather than reproducing IBM source. What was already fixed was dropped. TODO.md is what is left: the order of the open work, the reason for that order, and which items wait on a decision rather than on code. The ranking rule is the project's own - silent wrong output before silent under-reporting before a loud gap before cosmetics, and inside the top class, having already shipped broken code breaks the tie. Also added: docs/tool-roadmap.md, the roadmap for tools beyond the four that build, and docs/entry-point-resolution.md, which issue #10 cites and which existed only locally until now.
The June version described a toolchain that no longer exists: it listed multi-track transport, the mbt host backend, the one-command driver and the built-in C library as open, and all four have landed since. It was also the last German document in the repository. Rewritten for what is true now - the whole build runs on the host and only the install touches MVS - and pointed at TODO.md for the open work rather than carrying a list of its own, which is how the old one went stale.
Contributor
Author
|
Added a second commit: |
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
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.
Replaces two local working notes (
TODO-LD370.md,TODO-ASM370.md— never committed, so nothing is lost from history) with one rankedTODO.mdplus the reference material they carried.Why the split
The notes mixed three things: open defects, settled history, and reference material about IFOX00 and the linkage editor. Only the first belongs in a tracker, only the third belongs in
docs/, and the second is mostly noise once it is fixed. So:docs/ld370-iewl-divergences.mdandas370/docs/ifox-option-parity.md. Both cite routines and line numbers rather than reproducing IBM source; the provenance note explains why that line is drawn where it is.CXDbecoming a proper "not implemented" diagnostic.TODO.mdModelled on
mvslovers/httpd's: the tracker stays the source of truth, and this file holds what it cannot — the order, the reason for it, and what waits on a decision. The ranking rule is the project's own: silent wrong output before silent under-reporting before a loud gap before cosmetics, and inside the top class, having already shipped broken code breaks the tie. That puts #39 (MNOTE severity swallowed — the FREEMAIN it silently deleted in libc370 leaked exactly when storage was short) first.Two corrections the review turned up
build_userdata()has carried a packed member's complete PDS2 user-data — AC, RENT/REUS included — since June, for-iebcopyinputs. The issue packs a bare.lm, which has no directory to carry anything from. Its "adjacent observation" (--norentbyte-identical) is not a bug either: attributes live only in the directory entry. Both recorded in the issue.Also here
docs/tool-roadmap.md— the roadmap for tools beyond the four that build (objdump370,nm370,iebcopy370, …), rewritten in English, withlibobj370/libmvs370as the recommended Phase 0.docs/entry-point-resolution.md— cited by Startup customization via same-named @@START is fragile under autocall (multi-module) #10 and by the ld370 notes, but existing only locally until now. Facts re-checked against the tree before committing.Documentation only; no code changes.