andrew/libakstdlib
1
0
Fork 0
Code Issues 27 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Document libc wrapper contract #30

Merged
andrew merged 1 commits from 9 into main 2026-08-03 06:53:06 -04:00
Conversation 0 Commits 1 Files Changed 1 +9
tachikoma commented 2026-08-03 06:40:23 -04:00
Collaborator
Copy Link

References #9.

Document the library rule that libc behaviour is the default unless a compelling, documented reason says otherwise. Record that functions without a failure or operation-status result are not wrapper candidates, including umask().

No library code or tests changed. The mutating sys/stat.h surface is tracked separately in #29.

References #9. Document the library rule that libc behaviour is the default unless a compelling, documented reason says otherwise. Record that functions without a failure or operation-status result are not wrapper candidates, including `umask()`. No library code or tests changed. The mutating `sys/stat.h` surface is tracked separately in #29.
tachikoma added 1 commit 2026-08-03 06:40:24 -04:00
Document libc wrapper contract
All checks were successful
libakstdlib CI Build / coverage (push) Successful in 2m47s
Details
libakstdlib CI Build / sanitizers (push) Successful in 2m57s
Details
libakstdlib CI Build / cmake_build (push) Successful in 3m15s
Details
libakstdlib CI Build / mutation_test (push) Successful in 12m35s
Details
58f426abce 
Co-authored-by: Andrew Kesterson <andrew@aklabs.net>
andrew merged commit be725f8cf2 into main 2026-08-03 06:53:06 -04:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
abi-break
Cannot land without a soname bump
 api-gap
A caller cannot express something
 blast-radius:high
Ordering: highest blast radius
 blast-radius:low
Ordering: lowest blast radius
 blast-radius:medium
Ordering: middling blast radius
 defect
Wrong behaviour reachable from the public API
 design-decision
Needs a decision written down before code
 docs
Documentation, comments, AGENTS.md
 hygiene
Style, dead code, consistency
 packaging
Build, install, pkg-config, CMake config
 performance
Has a measurement behind it
 status::blocked
Waiting on something else -- a decision, a dependency, or another issue
 status::grooming
Not yet worked out: scope, approach or priority still being settled
 status::ready
Understood well enough to start: scope and approach are settled
 test-coverage
A gap in the suites, not a defect
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
tachikoma andrew
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: andrew/libakstdlib#30
Delete Branch "9"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?