Skip to content

Name the conformance section that exists, not one that does not - #13

Merged
Sunrisepeak merged 1 commit into
mainfrom
fix/name-the-section-that-exists
Aug 27, 2026
Merged

Name the conformance section that exists, not one that does not#13
Sunrisepeak merged 1 commit into
mainfrom
fix/name-the-section-that-exists

Conversation

@Sunrisepeak

Copy link
Copy Markdown
Member

src/exec.cpp said "tests/conformance_exec.cpp is where that distinction stops being an argument". That path is in this repository and there is no such file — the section is the specification's, at conformance/src/sections/exec.cpp, reached through run-conformance.sh openkal-macos . full,optional.

⚠️ A comment naming the place a question is answered is a promise. One pointing at nothing sends a reader to look and leaves them unable to tell whether the check is missing or the reference is — the same defect musl/PATCHES.md was corrected for an hour ago.

Found by reading every file path the new comments name and checking each exists, rather than by anything failing.

⚠️ `src/exec.cpp' said "tests/conformance_exec.cpp is where that
distinction stops being an argument". That path is in THIS repository and
there is no such file: the section is the specification's, at
`conformance/src/sections/exec.cpp', and this package reaches it through
`run-conformance.sh openkal-macos . full,optional'.

A comment naming the place a question is answered is a promise. One
pointing at nothing sends a reader to look and leaves them unable to tell
whether the check is missing or the reference is --- which is the same
defect musl/PATCHES.md was just corrected for, found by reading every
file path the new comments name.
@Sunrisepeak
Sunrisepeak merged commit 04fba62 into main Aug 27, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants