Skip to content

docs: LWJGL correction for BAF + upstream contribution tracking - #26

Merged
bernardladenthin merged 2 commits into
mainfrom
docs
Aug 2, 2026
Merged

docs: LWJGL correction for BAF + upstream contribution tracking#26
bernardladenthin merged 2 commits into
mainfrom
docs

Conversation

@bernardladenthin

Copy link
Copy Markdown
Owner

Summary

Two independent documentation changes, one commit each.

edc0526 — replace JOCL with LWJGL in BAF's GPU/fat-jar notes. BAF's
OpenCL 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 now
    points at LWJGL's MemoryStack / MemoryUtil as the current off-heap
    allocators.
  • policies/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 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 between
sessions:

  • 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_PREREQ in a flat #if is a
    parse error, not a false condition, on non-glibc platforms.
  • llama.cpp/contributions.md — per-patch upstream assessment of 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 silently reverted a local patch. Also notes llama.cpp's AGENTS.md
    rule that agents must not write PR or issue prose.

Test plan

  • Docs-only; this repo has no build. Nothing to run beyond the repo's own
    CI (REUSE / link checks).
  • Both new .md files are covered by the existing **/*.md annotation in
    REUSE.toml, so no new REUSE entry is needed.

bernardladenthin and others added 2 commits August 3, 2026 00:02
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>
@bernardladenthin
bernardladenthin merged commit 743a11f into main Aug 2, 2026
2 checks passed
@bernardladenthin
bernardladenthin deleted the docs branch August 2, 2026 22:04
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.

1 participant