Skip to content

Commit 304487b

Browse files
2026.10.31.1: features in every envelope, program in self env; #868; #866/#867 follow-ups; canary build steps; --pkg-format polyglot; ldflags files as link inputs (#869)
* design 2026-10-30 part 2: mcpp plugins and mcppls -- layers, the project's mcpp, mcppls's contract, entries, test cases, the manifest's rules as LSP, CLion native, distribution; one file for every system (#849): the APE and polyglot probes, the polyglot carrier model Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com> * 2026.10.31.1: `features` in --protocol-version and every envelope, `program` in self env, and how a tool runs mcpp for a project (docs/50) A client gates on a feature (`target-sets`, `pkg-format-list`) rather than a version number; every envelope's `mcpp` field carries the list beside the version, so one `self env` gives both and a job's envelope says when either changed. `self env` names the file that is running, so a tool that ran `mcpp` through a shim in a project's directory reads which mcpp the project uses. Design 2026-10-30 part 2 §4.0, §4.3. Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com> * a workspace's lock entry is keyed the same way whatever members a command plans (#868) Two members spelling one dependency two ways (`tinyhttps.workspace = true` and `[dependencies.mcpplibs] tinyhttps.workspace = true`) made `-p` of each write its own key and hash. The key is now the workspace's spelling: its `[dependencies]`, `[workspace.dependencies]`, then every member in the order `members` lists them, selected or not (docs/07, e2e 990). Closes #868 Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com> * the follow-ups of #866 and #867: a bare partial requirement is a caret; the TOML writer escapes every control character #866: a bare requirement is a caret, so "0" and "0.0" take the wildcard bounds as well (<1.0.0, <0.1.0); a unit test pins bare against caret, docs/05 states it in both languages. #867: with \b, \f and \uXXXX read, a value may hold any control character; escape_string escapes U+0000-U+001F and U+007F (short forms where TOML has one, \uXXXX elsewhere, never the reader's \0), so serialize writes TOML. A round trip test covers every control character. Design 2026-10-30 part 2 §17. Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com> * release canaries print the longest build steps of every build they made A canary's time is mostly its project's build (xlings: 1750 s of 47 min); each canary now ends with the 20 longest steps read from every .ninja_log beneath it, and `release_canaries.py steps <dir>` prints them for any tree. Design 2026-10-30 part 2 §11. Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com> * a file [build] ldflags names by absolute path is a link input A replaced prebuilt archive named in [build] ldflags did not relink the program: the word reached the linker but no link edge depended on it, and the clangd ok-image probe deleted its image to take a new library. A word that names an existing file by absolute path is now an implicit input of every non-archive link that carries it (docs/04, e2e 991). Design 2026-10-30 part 2 §25.3 C1. Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com> * one file for several systems: --pkg-format polyglot (SPEC-014 2.1 §5.3, #849) An ok image's single files of every leg and system (--systems all unless stated) are assembled into one <name>-<version>.exe. The Windows program leads: its DOS header is a shell assignment (MZqFpD='...') followed by a two-line script, the PE header moves down by a multiple of the file alignment and the offsets it holds move with it; the other systems' programs follow unchanged, and the POSIX script last. Windows starts the file as the PE it is (Authenticode signs it); Linux and macOS start it through sh, which copies the system's program to the single-file cache by SPEC-014 §5.2's rules, checks its sha256 and executes it. Without Windows the file is a #!/bin/sh script. The carriers are signed before assembly (the Windows one excepted) and the file after. polyglot is not in a --pkg-format list, a native target is refused, and mcpp emit xpkg names the file it refuses. mcpp run --pkg-format single-file and polyglot run the file directly (polyglot through sh on POSIX); they were refused as unknown formats; tar, zip and dir are refused as containers. Design 2026-10-30 part 2 §19.6; e2e 992, unit test_pack_polyglot. Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com> * CI: the new e2e tests' durations in the Linux shards; e2e 992 also in the wine job, where its file runs as a Windows program Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com> * the binary states 2026.10.31.1; #868 reads each member's manifest as written The version module still named 2026.10.30.1 (help, version and the subsystem contract test compare it with mcpp.toml). Loading every member through load_member_manifest for its spelling of a dependency also ran the inheritance a planned member receives, whose position-reading notes then reached the root's own build (e2e 911 R5); the manifests are now read as written, the way workspace_members reads them. Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com> * a tree's POSIX launcher names macOS's quarantine mark on its runner, with the command that removes it A package a browser downloaded carries com.apple.quarantine on every file, and macOS refuses to start an unsigned runner so marked; the launcher says so before it starts the runner (SPEC-014 §4.3; mcpp design 2026-10-30 part 2 §10 D6). Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com> * docs: the part 2 design is active and indexed; docs/50's heading for how a tool runs mcpp is a noun phrase Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com> --------- Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
1 parent 9c65437 commit 304487b

44 files changed

Lines changed: 2182 additions & 66 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.agents/docs/2026-10-30-ecosystem-part2-ide-and-language-service-design.md‎

Lines changed: 836 additions & 0 deletions
Large diffs are not rendered by default.

‎.agents/docs/README.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ superseded_by: 2026-09-07-....md # when status is superseded
1818
---
1919
```
2020

21-
342 records.
21+
343 records.
2222

2323
## By subject
2424

@@ -69,6 +69,10 @@ Records that declare one. Everything else is listed by date below.
6969
- [生态设计 part 2:openkal 的最小原子与二进制映像、其上的 `mcpplibs.os`,以及 part 1 的收尾与回归记录](2026-10-26-ecosystem-part2-os-library-over-openkal-design.md) — active
7070
- [控制契约、并发与性能、单一 C++ 运行时,以及 IDE 生态(生态级,#838、#839)](2026-10-26-control-contract-runtime-and-ide-ecosystem-design.md) — active
7171

72+
### editors
73+
74+
- [生态设计 part 2:mcpp 插件与 mcppls 的分层、入口、测试、版本感知与分发](2026-10-30-ecosystem-part2-ide-and-language-service-design.md) — active
75+
7276
### heterogeneous
7377

7478
- [A dlopen surface no closure walks, and a process with two unwinders](2026-09-09-dlopen-surface-and-two-unwinders.md) — landed
@@ -151,6 +155,7 @@ Records that declare one. Everything else is listed by date below.
151155

152156
### 2026-10
153157

158+
- [生态设计 part 2:mcpp 插件与 mcppls 的分层、入口、测试、版本感知与分发](2026-10-30-ecosystem-part2-ide-and-language-service-design.md) — active
154159
- [另一架构的 ok 映像的运行、测试与打包,以及 ok 映像与 Web 的关系(2026.10.29.1)](2026-10-29-openkal-run-test-pack-design.md) — active
155160
- [生态设计:目标集合与腿、打包模型 rev、运行覆盖、不回落、外部构建接入、mcppls 单包与编辑器](2026-10-29-ecosystem-target-sets-packaging-and-editors-design.md) — active
156161
- [平台 part 2:打包与分发——三维模型、通用包、单文件、okb、体积,以及 openkal 0.17.2 轮](2026-10-28-platforms-part2-packaging-and-distribution-design.md) — landed

‎.github/tools/release_canaries.py‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@
55
release_canaries.py matrix the GitHub Actions matrix, as `matrix=<json>`
66
release_canaries.py unpin <checkout> remove the project's own mcpp pin from its checkout
77
release_canaries.py run <name> run a canary's commands in the current directory
8+
release_canaries.py steps [<dir>] the longest build steps of the builds under <dir>
89
910
`run` reads the candidate from `$MCPP`. Each command runs under bash with
1011
`set -eo pipefail`, so a failure is the command's own; a command listed under
@@ -16,6 +17,11 @@
1617
launcher, because the loader searches the system directory before PATH (the
1718
first release run of these canaries printed "Windows Subsystem for Linux has
1819
no installed distributions" for every command).
20+
21+
After its commands, `run` prints the longest steps (compile or link, and the
22+
output) of every build the canary made, read from each `.ninja_log` beneath the
23+
current directory: a canary's time is mostly its project's build, and the steps
24+
say where (design 2026-10-30 part 2 §11).
1925
"""
2026
from __future__ import annotations
2127

@@ -79,6 +85,46 @@ def shell_argv(command: str) -> list[str]:
7985
return [shell, "-c", f"set -eo pipefail\n{command}"]
8086

8187

88+
def longest_steps(root: Path, count: int = 20) -> list[tuple[int, str, str]]:
89+
"""(milliseconds, build directory, output) of the longest steps in every
90+
`.ninja_log` beneath `root`. A log holds every build of its directory; the
91+
last line for an output is its latest step."""
92+
steps: list[tuple[int, str, str]] = []
93+
for log in root.rglob(".ninja_log"):
94+
latest: dict[str, int] = {}
95+
try:
96+
lines = log.read_text(encoding="utf-8", errors="replace").splitlines()
97+
except OSError:
98+
continue
99+
for line in lines:
100+
if line.startswith("#"):
101+
continue
102+
fields = line.split("\t")
103+
if len(fields) < 4 or not fields[0].isdigit() or not fields[1].isdigit():
104+
continue
105+
latest[fields[3]] = int(fields[1]) - int(fields[0])
106+
where = str(log.parent.relative_to(root)) if log.parent != root else "."
107+
steps += [(ms, where, out) for out, ms in latest.items()]
108+
steps.sort(key=lambda s: s[0], reverse=True)
109+
return steps[:count]
110+
111+
112+
def print_steps(root: Path) -> None:
113+
steps = longest_steps(root)
114+
if not steps:
115+
print(f"no .ninja_log beneath {root}")
116+
return
117+
print("::group::the longest build steps", flush=True)
118+
for ms, where, out in steps:
119+
print(f"{ms / 1000:9.1f} s {where} {out}")
120+
print("::endgroup::", flush=True)
121+
122+
123+
def cmd_steps(root: str) -> int:
124+
print_steps(Path(root).resolve())
125+
return 0
126+
127+
82128
def cmd_run(name: str) -> int:
83129
mcpp = os.environ.get("MCPP", "")
84130
if not mcpp:
@@ -103,6 +149,7 @@ def cmd_run(name: str) -> int:
103149
want = expect.get(command)
104150
if want and want not in proc.stdout + proc.stderr:
105151
failed.append(f"`{command}` did not print `{want}`")
152+
print_steps(Path.cwd())
106153
for f in failed:
107154
print(f"::error::canary {name}: {f}")
108155
print(f"canary {name}: {len(c['commands']) - len(failed)} of {len(c['commands'])} command(s) held")
@@ -119,6 +166,8 @@ def main(argv: list[str]) -> int:
119166
return cmd_unpin(argv[1])
120167
if argv[0] == "run" and len(argv) == 2:
121168
return cmd_run(argv[1])
169+
if argv[0] == "steps" and len(argv) <= 2:
170+
return cmd_steps(argv[1] if len(argv) == 2 else ".")
122171
print(__doc__)
123172
return 2
124173

‎.github/workflows/cross-build-test.yml‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -443,6 +443,17 @@ jobs:
443443
grep -qxF "PASS: 988 the Windows launcher finds its package from a Windows path" "$log" \
444444
|| { echo "::error::988 did not print its PASS line"; exit 1; }
445445
446+
# A polyglot file (SPEC-014 §5.3) is the Windows program as it is: its
447+
# criterion H runs the file under wine, which only this job has.
448+
- name: "e2e: a polyglot file runs on every system it holds (992)"
449+
run: |
450+
set -o pipefail
451+
export MCPP_VENDORED_XLINGS="$XLINGS_BIN"
452+
log="$RUNNER_TEMP/992.log"
453+
bash tests/e2e/992_a_polyglot_file_runs_on_every_system_it_holds.sh 2>&1 | tee "$log"
454+
grep -qxF "ok: the file is a Windows program" "$log" \
455+
|| { echo "::error::992 did not run the file under wine"; exit 1; }
456+
446457
# 257 needs a Linux-hosted MinGW compiler AND wine, which only this job
447458
# has; on the shards it skipped, and it had run on no runner (finding F9
448459
# of the 2026-10-02 CI record).

‎CHANGELOG.md‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,61 @@
44
> Each `## [<version>]` section is that release's notes. Entries are written in English
55
> from 2026.9.28.3 on; earlier entries remain as written.
66

7+
## [2026.10.31.1] - 2026-10-31
8+
9+
### Added
10+
11+
- **`features` in `mcpp --protocol-version`.** A client gates on a feature
12+
rather than on a version number: `target-sets` and `pkg-format-list` name the
13+
meanings 2026.10.30.1 introduced. A name is added when a client gates on it,
14+
and is never renamed or removed (docs/50 §4). Every envelope's `mcpp` field
15+
carries the same list beside the version, so one `self env` gives a client
16+
both, and a job's envelope says when either has changed.
17+
- **`program` in `mcpp self env --format json`**: the file that is running. A
18+
tool that ran `mcpp` through a version manager's shim in a project's directory
19+
reads which mcpp the shim chose for that project. docs/50 states how a tool
20+
runs mcpp for a project: in its root, by the name on `PATH` or a set path,
21+
with `XLINGS_PROJECT_DIR` removed (design 2026-10-30 part 2 §4.0).
22+
23+
- **One file for several systems: `--pkg-format polyglot`** (SPEC-014 §5.3,
24+
#849). An ok image's single files of every leg and system are assembled into
25+
one `<name>-<version>.exe`: the Windows program leads with a POSIX shell
26+
script in its DOS header, the other systems' programs follow unchanged.
27+
Windows starts it as itself (Authenticode signs it); Linux and macOS start it
28+
through `sh`, which copies the system's program to the single-file cache once,
29+
checks its sha256 and executes it. `mcpp run --pkg-format polyglot` starts it
30+
through `sh`; `mcpp emit xpkg` refuses it; it is not in a `--pkg-format` list
31+
(e2e 992).
32+
- **`mcpp run --pkg-format single-file`** runs the single file directly; it was
33+
refused as an unknown format. `tar`, `zip` and `dir` are refused as containers
34+
that are not programs.
35+
36+
- **A tree's POSIX launcher names macOS's quarantine mark.** A package a browser
37+
downloaded carries `com.apple.quarantine` on every file, and macOS refuses to
38+
start an unsigned runner so marked; the launcher says so before it starts the
39+
runner, with `xattr -dr com.apple.quarantine <package>` (SPEC-014 §4.3).
40+
41+
### Fixed
42+
43+
- **A workspace's lock entry is keyed the same way whatever members a command
44+
plans** (#868). Two members spelling one dependency two ways
45+
(`tinyhttps.workspace = true`, `[dependencies.mcpplibs] tinyhttps.workspace =
46+
true`) made `-p` of each write its own key and hash. The key is the
47+
workspace's spelling: its `[dependencies]`, `[workspace.dependencies]`, then
48+
the members in the order `members` lists them (docs/07, e2e 990).
49+
- **A file `[build] ldflags` names by absolute path is a link input.** A
50+
replaced prebuilt archive did not relink the program that names it; now every
51+
link that carries the word depends on the file (docs/04, e2e 991).
52+
- **A partial caret or tilde requirement treats unwritten segments as
53+
wildcards** (#866, NopeCharon): `^0` is `< 1.0.0`, `^0.0` is `< 0.1.0`, `~1` is
54+
`< 2.0.0`. A bare requirement is a caret, so the bare partial spellings `"0"`
55+
and `"0.0"` take the same bounds; before, they matched 0.0.0 alone (docs/05).
56+
- **The TOML reader accepts every escape TOML 1.0 defines** (#867, NopeCharon):
57+
`\b`, `\f`, `\uXXXX` and `\UXXXXXXXX`. The writer escapes every control
58+
character in turn (`\uXXXX` where TOML has no short form), so a normalised
59+
manifest that holds one is still TOML; `\0` is this reader's extension and is
60+
never written.
61+
762
## [2026.10.30.1] - 2026-10-30
863

964
### Added

‎docs/04-mcpp-toml.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -594,6 +594,12 @@ jobs = "auto" # Concurrent compiles: a positive number, or "
594594
bmi_schedule = "auto" # Module-edge scheduling: auto (= off) | on | off (§ below)
595595
```
596596

597+
A word of `[build] ldflags` that names an existing file by absolute path (a
598+
prebuilt archive, an object) is an input of every link that carries it: a
599+
changed file relinks (mcpp 2026.10.31.1+). A relative word is read by the
600+
linker against the build directory and is not tracked.
601+
602+
597603
#### Compile-flag syntax *(mcpp 2026.9.17.1+)*
598604

599605
An element of `cflags`, `cxxflags` or `asmflags` stands for one or more compiler

‎docs/05-dependencies.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,13 @@ baz = "=1.2.3" # Exact match
121121
qux = ">=1.0, <2.0" # Range combination
122122
```
123123

124+
A bare requirement is a caret: `foo = "1.2.3"` is `^1.2.3`, except that a bare
125+
version equal to a published key addresses that key exactly. A bare partial
126+
spelling follows the caret's wildcard rule as well: `"0"` is `>= 0.0.0, < 1.0.0`
127+
and `"0.0"` is `>= 0.0.0, < 0.1.0` (before 2026.10.31.1 both matched 0.0.0
128+
alone). The dependency conflict check and the address check of `--locked` read
129+
requirements the same way.
130+
124131
### `visibility` — whether a dependency's usage crosses this package's own boundary
125132

126133
```toml

‎docs/07-workspace.md‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -712,7 +712,11 @@ myproject/
712712
one, covers every member that has been built or configured.
713713
- `mcpp.lock` at the workspace root records the resolution of every member.
714714
`mcpp build --workspace` writes the whole record; `mcpp build -p X` updates
715-
the entries of X's graph.
715+
the entries of X's graph. An entry's key is the spelling under which the
716+
workspace declares the dependency: its own `[dependencies]`, then
717+
`[workspace.dependencies]`, then each member in the order `members` lists
718+
them, whether the command selects it or not. The key and its hash therefore
719+
do not depend on which members a command plans.
716720
- A member's build program writes to `<member>/target/.build-mcpp/`. The
717721
members' build programs are compiled in the workspace's build programs'
718722
graph, `target/.build-mcpp/host/`, and a library several of them import is

‎docs/10-pack-and-release.md‎

Lines changed: 41 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ A pack is decided by three independent choices and a set of legs (2026.10.27.1+)
6363
|---|---|---|---|
6464
| linkage | `--linkage` | are the libraries inside the program or beside it | `static`, `shared` |
6565
| closure | `--mode` | what the machine that runs the package provides | `system`, `vendored` (default), `self-contained` |
66-
| container | `--pkg-format` | what is delivered | `tar`, `zip`, `dir`, `single-file`, a format a package provides, or a list of containers of one tree (`tar,okb`); unstated: `zip` for a Windows program, `tar` elsewhere |
66+
| container | `--pkg-format` | what is delivered | `tar`, `zip`, `dir`, `single-file`, `polyglot`, a format a package provides, or a list of containers of one tree (`tar,okb`); unstated: `zip` for a Windows program, `tar` elsewhere |
6767
| legs | `--target`, repeatable | which targets the pack covers | targets and target sets (`x86_64-openkal`, `openkal`, `linux-musl`) |
6868
| systems | `--systems` | which systems a self-contained package's runners, or single files, are for | `linux`, `linux-aarch64`, `all` |
6969

@@ -135,7 +135,9 @@ choices:
135135
| several images of a platform that states no `runner`, not as single files | one pack per target, or `--pkg-format single-file` |
136136
| `--target` outside the platform's targets | a target the platform serves |
137137
| a target set that expands to nothing, or whose rows select different platforms | a target, or another set |
138-
| `dir` or `single-file` in a `--pkg-format` list; a list with `-o` naming one file; a list on `mcpp run` | one format, or `-o <directory>/` |
138+
| `dir`, `single-file` or `polyglot` in a `--pkg-format` list; a list with `-o` naming one file; a list on `mcpp run` | one format, or `-o <directory>/` |
139+
| `--pkg-format polyglot` for a program of one system (a native target) | `--pkg-format single-file`, or `--target openkal` |
140+
| `mcpp run --pkg-format tar`, `zip` or `dir` | `--pkg-format single-file` or `polyglot`, or a format a package provides |
139141
| `--mode self-contained` of an image with `okb` as the only format | `--pkg-format tar,okb`: okb holds the images alone, and the runner would be dropped |
140142
| a tree that runs nowhere (`runs_on` empty) | `--mode self-contained --systems <a system this mcpp builds for>` |
141143
| a dispatched format for a `lib` or `shared` target | the library route, [12](12-binary-distribution.md) |
@@ -910,6 +912,36 @@ A WebAssembly target has no single file: `--pkg-format single-file` with
910912
`--target wasm32-emscripten` is refused before anything compiles
911913
(2026.10.29.1+), and its page is the `dist-web` provider's format.
912914

915+
### One file for several systems (`polyglot`, mcpp 2026.10.31.1+)
916+
917+
`--pkg-format polyglot` assembles an image's single files of every leg and
918+
system (`--systems all` unless `--systems` says otherwise) into one file,
919+
`target/dist/<name>-<version>.exe`:
920+
921+
```bash
922+
mcpp pack --target openkal --pkg-format polyglot -o dist/
923+
# Runs on linux-x86_64, windows-x86_64, linux-aarch64, macos-aarch64
924+
```
925+
926+
The Windows program leads, with a POSIX shell script in its DOS header; the
927+
other systems' programs follow it unchanged. Windows starts the file as the
928+
program it is, and Authenticode signs it. A Linux or macOS system starts it
929+
through a shell — `sh pg-0.1.0.exe`, or `./pg-0.1.0.exe` typed in a shell, which
930+
runs a file the kernel refuses as a script; a program that calls `execve` on it
931+
directly gets `Exec format error`. The script copies this system's program to
932+
the single-file cache, `<cache>/mcpp/single-file/<sha256 of the program>/`,
933+
with the rules of a native single file (a name of its own, `.mcpp-complete`,
934+
rename without replacing, the user's directories only), checks its sha256 there
935+
(`sha256sum`, `shasum` or `openssl`), and executes it; later runs start it from
936+
the cache. A system the file holds no program for exits with status 126 and
937+
names the systems it holds. Without `windows` among `--systems` the file is a
938+
script (`#!/bin/sh`) the system executes directly, named without `.exe`.
939+
940+
`polyglot` is for a download a person runs. It is not in a `--pkg-format` list,
941+
a native target is refused (its single file is one system's), `mcpp run
942+
--pkg-format polyglot` starts it through `sh`, and `mcpp emit xpkg` refuses it:
943+
an xlings entry installs one system's package, the tree or the single files.
944+
913945
### `mcpp-package.json`
914946

915947
Every staged tree carries `mcpp-package.json`: the package, its platform, its
@@ -964,7 +996,10 @@ inside an okb are stored so that the loader maps them in place.
964996
`[pack] sign = ["<prog>", …, "{}"]` runs once on each program, image, library
965997
and loader of the staged tree and on the Windows launcher before the container
966998
is written, and on each
967-
single file; `{}` is the file. A failure stops the pack, naming the argv and its
999+
single file; `{}` is the file. A polyglot file's programs are signed one by one
1000+
before they are assembled, except the Windows program, and the assembled file
1001+
is signed last: Authenticode appends its certificate, which leaves every byte
1002+
and offset before it as it was. A failure stops the pack, naming the argv and its
9681003
output, and `mcpp-package.json` states the digests of the signed files.
9691004

9701005
## Configuration
@@ -1012,8 +1047,9 @@ The `static` mode additionally requires a musl toolchain configured under
10121047
- Distribution formats such as `.deb`, `.rpm`, AppImage and `.msi` come from
10131048
packages through `--pkg-format <name>`; the engine provides `tar`, `dir`, `zip`
10141049
and `single-file`.
1015-
- One file that runs on several systems is not produced; a single-file package
1016-
serves one system and one architecture.
1050+
- A polyglot file holds the systems and architectures this mcpp builds a
1051+
single file for (today Linux x86_64 and aarch64, macOS aarch64, Windows
1052+
x86_64), and only for ok images; a POSIX system starts it through a shell.
10171053
- A WebAssembly package is neither a single file nor an xlings entry; its page is
10181054
a provider's format (`dist-web`).
10191055
- An ELF program's closure is resolved by running its dynamic linker, so a Linux

0 commit comments

Comments
 (0)