Skip to content

docs: supported platforms are Linux x86_64 and arm64 from 1.8.0 - #545

Merged
luisleo526 merged 3 commits into
mainfrom
docs/supported-platforms-linux-named
Oct 27, 2026
Merged

luisleo526 merged 3 commits into
mainfrom
docs/supported-platforms-linux-named

Conversation

@luisleo526

Copy link
Copy Markdown
Collaborator

What

Documentation only. Engine 1.8.0 is built, tested and published for Linux only (x86_64 and arm64): no macOS archive is published and CI runs no macOS jobs. This states that in the places a reader looks.

  • README.md: one "Supported platforms: Linux x86_64 and arm64" line; the macOS deployment target and the macOS CI claim are dropped; "Same on Linux and macOS" is dropped; the Linux compile line is the primary one and the macOS/Clang flags stay as a note; the CI list names the Linux legs.
  • CONTRIBUTING.md, docs/pages/getting-started.md, docs/pages/install.md: the same wording. install.md says that releases up to 1.7.0 also carry a macOS archive and that 1.8.0 and later publish the two Linux archives only.
  • CHANGELOG.md: a "Supported platforms" bullet in the 1.8.0 "Compatibility and migration" section, one clause in the section introduction, and the wording of the release-gate bullet (Linux build legs).

The Linux compile line in the README tutorial is the form the previous paragraph already gave for Linux (-Wl,--whole-archive ... -Wl,--no-whole-archive, no -fbracket-depth for GCC): it is promoted to the main example, not new advice; the Clang and macOS flags stay as a note.

History of earlier releases (including the v1.3.0 archive list) and neutral build notes (-lc++ on macOS, brew install, shasum) are unchanged.

Order

The statements about CI legs and the published archives are true once the change that removes the macOS jobs and the macOS release slice has merged. Merge this after it.

Checks

Documentation only: the preflight guards and the documentation build.

Supersedes #530 with the same trees: the first commit message now names the two sentences it removes and the commit that introduced them (b2a578c).

🤖 Generated with Claude Code

luisleo526 and others added 3 commits October 27, 2026 08:57
Engine 1.8.0 is built, tested and published for Linux only (x86_64 and
arm64); no macOS archive is published and CI runs no macOS jobs. Documentation
only.

- README.md: state the supported platforms once, drop the macOS deployment
  target and the macOS CI claim, drop "Same on Linux and macOS", make the
  Linux compile line the primary one and keep the macOS/Clang flags as a note.
- CONTRIBUTING.md, docs/pages/getting-started.md, docs/pages/install.md: the
  same wording; install.md says releases up to 1.7.0 also carry a macOS archive.
- CHANGELOG.md: a "Supported platforms" bullet in the 1.8.0 compatibility
  section and the 1.8.0 CI leg wording.

Two sentences leave on purpose, both introduced by b2a578c ("docs: make every
README and doc page true before the release (DOCS-ENGINE) (#300)"): the README
sentence that began "The compile line is macOS/Clang's: on Linux link
-Wl,--whole-archive /usr/local/lib/libpineforge.a -Wl,--no-whole-archive, and
drop -fbracket-depth" (the Linux line is now the main example and the macOS
flags a note), and the getting-started requirement "libstdc++ from GCC 11, or
libc++ 14; on macOS a deployment target of 13.3" (macOS is no longer a
supported target).

History of earlier releases and neutral build notes are unchanged.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
The "Supported platforms" bullet said twice that no macOS archive is
published. Keep the first statement and the sentence that a macOS build is
neither tested nor supported.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Takes main's changes since this branch was cut. One conflict, in the 1.8.0
section introduction of CHANGELOG.md: the branch said the release stops
building and publishing macOS and that the report keys are unchanged; main now
says the report keys are unchanged except for two additive diagnostics keys.
The resolved paragraph keeps both: main's report-keys sentence and the branch's
macOS clause. The other four files of this branch merge without conflict.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
@luisleo526
luisleo526 merged commit f66318a into main Oct 27, 2026
12 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.

1 participant