docs: record experimental-tier exclusion (CCtxParams) in binding scope#37
Merged
Conversation
dfa1
force-pushed
the
docs/cctxparams-scope
branch
2 times, most recently
from
0b0146a to
62aafbc
Compare
The ZSTD_CCtx_params bundle is ZSTDLIB_STATIC_API — experimental tier.
The symbols are exported (the macro resolves to visibility("default"),
so the FFM layer could bind them by name), but they carry no API-stability
guarantee and may change or be removed between zstd releases. The bundle
only saves a few setParameter calls at context init, and the stable
per-context ZSTD_CCtx_setParameter path (already bound) covers the same
need, so it is intentionally not bound. Extend ADR 0013 to exclude the
experimental tier and note the reason on the supported.md Advanced
parameters row.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
dfa1
force-pushed
the
docs/cctxparams-scope
branch
from
62aafbc to
a3fca47
Compare
dfa1
added a commit
that referenced
this pull request
Jun 27, 2026
Two project subagents under .claude/agents/, both pinned to Opus 4.8: - zstd-coder: implements changes against the project's FFM/segment-first conventions, runs ./mvnw validate before claiming done. - zstd-reviewer: read-only diff review focused on FFM memory safety, native sentinel handling, the zero-copy contract, test coverage, and the build gates (checkstyle, javadoc). Used as a coder -> reviewer loop; the reviewer already caught a factual error in #37 before merge. settings.local.json stays gitignored. Co-authored-by: Claude Opus 4.8 <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.
What
Documents why the
ZSTD_CCtx_paramsbundle is intentionally not bound.The CCtxParams cluster (
ZSTD_createCCtxParams,ZSTD_CCtxParams_setParameter,ZSTD_CCtx_setParametersUsingCCtxParams, …) isZSTDLIB_STATIC_API— experimental tier:ZSTD_STATIC_LINKING_ONLY, no stability guarantee-fvisibility=hiddenexport tablesetParametercalls at context init (never a hot path)ZSTD_CCtx_setParameterpath covers the same needChanges
—rows now have a "why"), linked to ADR 0013Docs only — no code, no API change.
🤖 Generated with Claude Code