You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit fcadaba
Browse filesBrowse the repository at this point in the historyBrowse files
SPEC-014 2.0: a pack holds the legs it names -- sets expand, images of a platform with a runner are one tree whatever the number of legs, other programs a package per leg; runs_on in the summary and the envelope; --systems <os>, <os>-<arch>, all; --pkg-format lists of one tree's containers; single files cover legs x systems; --merge writes the launchers again; the universal spellings migrated
Copy file name to clipboardExpand all lines: docs/35-platforms.md
+3-4Lines changed: 3 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -71,8 +71,8 @@ for this machine and one for an ok image leave each other's entries in place.
71
71
| the compile |`[platform.build]`, `[platform.build.'cfg(…)']`| flags for every unit of the target |
72
72
| the link |`[platform.link]`|`driver`, `flags`, `start`, `script`, `inputs`, the names `exe` and `shared`, the `seal` steps |
73
73
| the run |`runner`, `runners`| how `mcpp run` and `mcpp test` start an artifact, and named device actions |
74
-
| the carrier |`carrier`| the program `mcpp pack` builds of a loaded artifact for a system: the self-contained program, a universal package's runner, a single file |
75
-
| the package |`universal`|a pack of any target covers all of them, in one package ([10](10-pack-and-release.md)) |
74
+
| the carrier |`carrier`| the program `mcpp pack` builds of a loaded artifact for a system: a self-contained tree's runner, a single file; a table or a list of tables, each serving the `<os>-<arch>` pairs of its `hosts`|
75
+
|where the runner exists |`runner.hosts`|the `<os>-<arch>` pairs the runner's program exists for: where a package that needs it runs (`runs_on.with`, [10](10-pack-and-release.md)) |
76
76
| the code |`plugin`| a build program run in the platform phase, for what depends on the graph |
77
77
| the group |`[platform.versions]`| one version of each package of a family |
78
78
| the host part |`[platform.hosted]`| what a host triple takes when it selects the platform |
Copy file name to clipboardExpand all lines: docs/50-machine-output.md
+4-2Lines changed: 4 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -727,10 +727,12 @@ to stderr, including what the build programs and tools the pack starts print.
727
727
728
728
| field ||
729
729
|---|---|
730
-
|`artifacts`| one record per produced artifact: `path` (absolute), `type` (`file` or `directory`), `format` (the container: the `--pkg-format` value; when none is given, `zip` for a Windows program and `tar` otherwise), `targets` (the canonical triple of each leg that went into it) and `sha256` (a file's digest; `null` for a directory; 2026.10.27.1+). A dispatched format reports the terminal outputs of the actions the request introduced; a several-`--target` Android pack reports one artifact whose `targets` lists every leg |
730
+
|`artifacts`| one record per produced artifact: `path` (absolute), `type` (`file` or `directory`), `format` (the container: the `--pkg-format` value; when none is given, `zip` for a Windows program and `tar` otherwise), `targets` (the canonical triple of each leg that went into it) and `sha256` (a file's digest; `null` for a directory; 2026.10.27.1+). A dispatched format reports the terminal outputs of the actions the request introduced; a several-`--target` Android pack reports one artifact whose `targets` lists every leg; a pack of a package per leg (2026.10.30.1+) reports each package with its own leg|
731
731
|`stage`| the tree the artifact was made from: `dir`, `manifest` (the stage manifest below) and `closure` (`walked` or `not-walked`); `null` for a library package, when no tree was staged, and for a pack of several members |
732
732
|`linkage`, `mode`, `pkgFormat`*(2026.10.27.1+)*| the three choices of the pack ([10](10-pack-and-release.md)): `linkage` is `static`, `shared` or `declared`; `pkgFormat` is the `format` of the artifacts (`tar`, `zip`, `dir`, `single-file`, or a provided format) |
733
-
|`legs`, `systems`*(2026.10.27.1+)*| the canonical triple of each leg (a universal package lists every target of its platform), and the `<os>-<arch>` of each runner a self-contained universal package carries, or of the carrier that is the program of a self-contained package of one ok image (2026.10.29.1+) |
733
+
|`legs`, `systems`*(2026.10.27.1+)*| the canonical triple of each leg the command named (a target set expanded; 2026.10.30.1+), and the `<os>-<arch>` of each runner a self-contained tree of images carries |
734
+
|`pkgFormats`*(2026.10.30.1+)*| every container written, in the order `--pkg-format` named them; `pkgFormat` is the first |
735
+
|`runsOn`*(2026.10.30.1+)*| where the package runs, as its `mcpp-package.json``runs_on` says: `{"self": ["linux-x86_64", …], "with": {"okrun": […]}}`; a single file's pairs are its files' |
734
736
|`stages`*(2026.10.1.1+)*| present only for a pack of several members (`--workspace`, or `-p` repeated): one record per member in `[workspace] members` order, with `member` (the qualified package name) and the `dir`, `manifest` and `closure` of `stage`|
735
737
736
738
For a pack of several members `artifacts` lists every member's artifacts, in the
Copy file name to clipboardExpand all lines: docs/51-supported-versions.md
+3Lines changed: 3 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -80,6 +80,9 @@ the rows of this table (mcpp 2026.10.11.1+).
80
80
|`abi-capability`: an `abi:` runtime capability (`abi:glibc`, `abi:libc=<c>`, `abi:cxxstdlib=<c++>`), read as a requirement on a target-side layer | 2026.10.26.1 | 2027.1 |`requires = ["mcpp:c-abi=<impl>"]` or `["mcpp:c++-abi=<impl>"]`|
81
81
|`undeclared-cxx-runtime`: a C++ runtime other than the build's own, named on its link line or needed by a library the line names, that no package declares | 2026.10.26.1 | 2027.1 |`requires = [{ layer = "mcpp:c++-abi=<impl>", visibility = "private" }]` in the package that needs it |
82
82
|`plugin-imports-from-build-dependencies`: a build plugin's library importing a package it lists in its own `[build-dependencies]` with `host-module = true`| 2026.10.11.1 | 2027.1 | the package in the plugin's `[dependencies]`|
83
+
|`pack-universal`: `[pack] universal` -- `true` refused, `false` ignored; a pack's targets are its legs | 2026.10.30.1 | 2027.1 |`[pack] targets = ["openkal"]` (every architecture), or one `--target`|
84
+
|`platform-universal`: a platform's `[platform] universal`, ignored; a pack's targets are its legs | 2026.10.30.1 | 2027.1 | nothing in the platform; the pack names its targets (`--target openkal`) |
85
+
|`no-universal-flag`: `mcpp pack --no-universal`, which a pack of one target no longer needs (refused with a target set) | 2026.10.30.1 | 2027.1 |`--target <arch>-<os>` (one leg) |
0 commit comments