docs: LWJGL correction for BAF + upstream contribution tracking - #26
Merged
Conversation
BAF's OpenCL binding moved from JOCL to LWJGL, so the three places that named jocl as the source of BAF's off-heap memory and of its all-platform native bundling were stale. - CODE_WRITING_GUIDE-21.md: the FFM "not yet adopted" note now points at LWJGL's MemoryStack/MemoryUtil as the current off-heap allocators. - fat-jar-release-assets.md: the "never Central" rationale and BAF's row in the per-repo table. BAF still needs no classifier split, but for a different reason: LWJGL ships one natives-* classifier jar per platform and they may all sit on one classpath, with LWJGL picking the match at runtime, rather than jocl's single all-platform jar. - crossrepostatus.md: same correction in the fat-jar summary bullet. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…ss.h Records what has been offered upstream and what is deliberately kept downstream, so the state survives between sessions. subprocess.h/contributions.md — PRs #104/#105/#106, filed 2026-08-01 and still awaiting a maintainer to approve the workflow runs. Includes the container/compiler matrix the changes were verified against, the limitations left in on purpose, and preprocessor pitfalls worth carrying forward (notably that __GLIBC_PREREQ in a flat #if is a parse error on non-glibc platforms). llama.cpp/contributions.md — per-patch upstream assessment for the patches jllama applies downstream: 0001 filed as issue #26416, 0002 kept downstream for lack of an in-tree beneficiary, 0009 redirected to sheredom because scripts/sync_vendor.py owns the vendored file and would have reverted a local patch. Also notes llama.cpp's AGENTS.md rule that agents must not write PR or issue prose. Co-Authored-By: Claude Opus 5 (1M context) <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
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.
Summary
Two independent documentation changes, one commit each.
edc0526— replace JOCL with LWJGL in BAF's GPU/fat-jar notes. BAF'sOpenCL binding moved from JOCL to LWJGL, which left three places naming jocl
as the source of BAF's off-heap memory and of its all-platform native
bundling stale:
guides/src/CODE_WRITING_GUIDE-21.md— the FFM "not yet adopted" note nowpoints at LWJGL's
MemoryStack/MemoryUtilas the current off-heapallocators.
policies/fat-jar-release-assets.md— the "never Central" rationale andBAF's row in the per-repo table. BAF still needs no classifier split, but
for a different reason than before: LWJGL ships one
natives-*classifier jar per platform and they may all sit on one classpath, with
LWJGL picking the match at runtime, rather than jocl's single all-platform
jar. The conclusion is unchanged; only the reasoning behind it was wrong.
crossrepostatus.md— same correction in the fat-jar summary bullet.beb3dad— track upstream contributions, so the state survives betweensessions:
subprocess.h/contributions.md(new upstream folder) — PRs#104 /
#105 /
#106, filed
2026-08-01, still awaiting a maintainer to approve the workflow runs.
Records the container/compiler matrix they were verified against, the
limitations left in deliberately, and the preprocessor pitfalls worth
carrying forward — notably that
__GLIBC_PREREQin a flat#ifis aparse error, not a false condition, on non-glibc platforms.
llama.cpp/contributions.md— per-patch upstream assessment of thepatches jllama applies downstream:
0001filed as issue#26416,
0002keptdownstream for lack of an in-tree beneficiary,
0009redirected tosheredom because
scripts/sync_vendor.pyowns the vendored file and wouldhave silently reverted a local patch. Also notes llama.cpp's
AGENTS.mdrule that agents must not write PR or issue prose.
Test plan
CI (REUSE / link checks).
.mdfiles are covered by the existing**/*.mdannotation inREUSE.toml, so no new REUSE entry is needed.