Skip to content

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

Closed
luisleo526 wants to merge 3 commits into
mainfrom
docs/supported-platforms-linux
Closed

luisleo526 wants to merge 3 commits into
mainfrom
docs/supported-platforms-linux

Conversation

@luisleo526

@luisleo526 luisleo526 commented Oct 26, 2026 •

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.

🤖 Generated with Claude Code

luisleo526 and others added 3 commits October 26, 2026 21:33
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.

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

Copy link
Copy Markdown
Collaborator Author

Superseded by #545: same trees, with the first commit message naming the two sentences it removes.

@luisleo526 luisleo526 closed this Oct 27, 2026
luisleo526 added a commit that referenced this pull request Oct 27, 2026
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, one clause in the section introduction 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. Supersedes
#530, which carried the same tree.
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