mcpp.toml

[package]
name        = "project-subos"
version     = "0.1.0"
description = "A build program that finds its tools in an environment the project declared"

# THIS SECTION IS WHAT THE DIRECTORY IS FOR.
#
# `subos` names the environment this project builds in. mcpp already used that
# declaration to decide which C library the project links against, and it now
# also puts that environment's `bin` at the front of the `PATH` it runs
# `build.mcpp` with — so a bare command name in a build program resolves inside
# the environment the project named.
#
# A PROJECT THAT DECLARES NO `subos` GETS THE `PATH` mcpp WAS STARTED WITH.
# There is no shared directory quietly in front of every build; declaring one
# is what puts it there.
#
# `"default"` SO THIS EXAMPLE BUILDS ON A CLEAN CHECKOUT. The isolated form
# is a private name — `subos = "tools"`, resolved to
# `<project>/.mcpp/.xlings/subos/tools/` — and mcpp READS such an environment
# but never creates one, so a name nobody has bootstrapped is a hard error by
# design. See README.md.
[xlings]
subos = "default"

# The one table (2026.9.3.1+): an entry names a package and the version this
# project uses it at. mcpp provisions it and pins it, which is why the emulator
# below is both installed on the first build and the one the project resolves.
[xlings.workspace]
"xim:qemu-riscv" = "9.2.4-1"