|
4 | 4 | > Each `## [<version>]` section is that release's notes. Entries are written in English |
5 | 5 | > from 2026.9.28.3 on; earlier entries remain as written. |
6 | 6 |
|
| 7 | +## [2026.11.9.1] - 2026-11-09 |
| 8 | + |
| 9 | +### Added |
| 10 | + |
| 11 | +- **Targets and providers (SPEC-016).** A target request is a pattern: the |
| 12 | + rows it reaches, each with the providers that serve it, are ordered by |
| 13 | + priority, then by row, then by provider name, and the first one available on |
| 14 | + this host is taken; the build reports the request, the identity and, when the |
| 15 | + first candidate is not available, why. The built-in rows and providers are |
| 16 | + data (`modules/toolchain-model/data/builtin.toml`, compiled in by the |
| 17 | + package's build program). `[target.<selector>.priority] <provider> = <n>` |
| 18 | + changes the order; `platform = "builtin:<name>"` chooses a built-in provider. |
| 19 | +- A platform package defines rows and providers: `[[platform.define]]` (triple, |
| 20 | + clang-triple, object format, family, execution, ...) and |
| 21 | + `[[platform.provider]]` (serves, priority, hosts, pairs, toolchain, layers, |
| 22 | + link, hosted). `cfg(os = ...)` answers by a defined row; the parser accepts |
| 23 | + the systems and C libraries the resolved platforms define (mcpp#911 G1). |
| 24 | +- `mcpp why target` lists a request's candidates with their priorities and |
| 25 | + availability; `mcpp why flags [<unit>]` lists each word of a unit's command |
| 26 | + line and of the link line with the layer that gave it (row, replacement, |
| 27 | + platform, toolchain, package, engine). Both take `--format json`. The build |
| 28 | + record and the `plan` event carry `{request, identity, provider, priority, |
| 29 | + fallback}`; build programs read `mcpp::target_provider()` |
| 30 | + (`MCPP_TARGET_PROVIDER`). |
| 31 | +- `mcpp.lock` records `[target."<request>"]` with the identity and the |
| 32 | + provider; `--locked` refuses a build that selects another identity. |
| 33 | +- `[platform.replace]` and `[target.<selector>.replace]` replace the row's |
| 34 | + defaults (`-march=`, `-mabi=`, `-mcmodel=`, its flags, `-m <emulation>`) by |
| 35 | + name; a replacement that meets no word of the row is reported (mcpp#911 G2). |
| 36 | +- A sysroot or a provider that states a hosted C environment turns off |
| 37 | + `-ffreestanding` (G3); a platform's `link.driver = "compiler"` links any row |
| 38 | + (G4); an artifact for another system is not judged by this machine's loader |
| 39 | + (G5); a target-independent source artifact serves every target (G6). |
| 40 | +- `[defaults."<capability>"] <selector> = <package>`: a package's default |
| 41 | + provider of a capability it requires, taken when neither the graph nor the |
| 42 | + platform provides it (G7). |
| 43 | +- A patch names files from the package's root; `patch_root` names another |
| 44 | + directory. `mcpp patch edit <dependency>` and `mcpp patch save <dependency>` |
| 45 | + edit a dependency's sources and save the change as the edge's next patch |
| 46 | + (G8). |
| 47 | +- `[targets.<name>.build]` compiles the shared sources an artifact links with |
| 48 | + its own defines and flags, as the artifact's variant (G9). |
| 49 | +- A row a platform defines is packed and carries as a built-in row does; |
| 50 | + `--systems all` adds the systems the platforms define (G10). An artifact for |
| 51 | + another system is built, not run, until a runner -- a runner package's tool |
| 52 | + -- or an execution host states how it runs (G11). |
| 53 | +- The row `i686-none-elf` (G12). |
| 54 | +- clang pairs with the MinGW-w64 payload for `x86_64-windows-gnu`: the payload |
| 55 | + is clang's sysroot and libstdc++ its C++ library, `import std` included. |
| 56 | +- `mcpp new --template platform` and `mcpp check platform`. |
| 57 | +- `mcpp pack --all-programs` ships every program of a package. |
| 58 | +- A git reference that names no tag, rev or branch follows the remote's |
| 59 | + default branch; `--platform git+<url>[#tag=|rev=|branch=]`. |
| 60 | + |
| 61 | +### Changed |
| 62 | + |
| 63 | +- A request that names only a system takes the first available identity of |
| 64 | + that system: `x86_64-windows` on a host without MSVC is |
| 65 | + `x86_64-windows-musl` (openkal-platform), no longer `x86_64-windows-gnu`; |
| 66 | + `aarch64-macos` and `x86_64-macos` on another host are the `-musl` |
| 67 | + identities; `aarch64-linux` on an x86_64 host is `aarch64-linux-musl`. An |
| 68 | + identity written whole is not replaced. |
| 69 | +- The identity follows the C library: a project whose graph supplies musl |
| 70 | + builds `x86_64-linux` as `x86_64-linux-musl`; an explicit identity that |
| 71 | + disagrees with the graph's C library is refused (`target-cabi-conflict`). |
| 72 | +- A git dependency names at most one of rev, tag and branch. |
| 73 | +- `mcpp pack` with several programs packs the one named after the package and |
| 74 | + names the others, and refuses when none is so named. |
| 75 | +- mcpp's own unit tests are mtest cases (mtest 0.5.0, mcpplibs.os 0.4.1); a |
| 76 | + skeleton's tests use mtest 0.5.0. |
| 77 | + |
| 78 | +### Fixed |
| 79 | + |
| 80 | +- A manifest `mcpp pack` generates quotes a target name with a dot (B1). |
| 81 | +- A platform's artifact names stand over a build program's `artifact-name`; |
| 82 | + the conflict is reported (B2). |
| 83 | +- `mcpp pack` no longer packs one program of several without a word (B3). |
| 84 | +- A static ELF is not run to learn its closure. |
| 85 | + |
7 | 86 | ## [2026.11.8.1] - 2026-11-08 |
8 | 87 |
|
9 | 88 | ### Added |
|
0 commit comments