2.6 KiB
Dependency manifests
This repository contains dependency metadata and patches, not third-party program source trees. Original source is fetched from the pinned upstream release or repository revision and verified before use. Sources, licenses and notices are retained in the generated dependency directories; these directories are ignored by Git.
From the repository root:
# Core/app only:
python3 tools/dependencies/fetch.py --only toolshed
# Full compiler/library development preparation:
python3 tools/dependencies/fetch.py
python3 tools/toolchain/verify-sources.py
For an offline build, retain the verified original downloads under .build/dependencies/downloads, or supply an explicit archive cache to the fetcher. Fetching a new dependency is a separate network-enabled preparation step. Compilation and tests can then run offline. Sources are selected by exact file hashes; exclusions keep ROMs and separately licensed inputs out of the prepared tree. Import patches recorded in the manifests are applied before final hash verification. Compiler/debug extensions are applied reproducibly to build copies by tools/toolchain/build.py.
The shared bootstrap is tools/dependencies/fetch.py; its supplemental tools/dependencies/manifests/legacy-graphics.json fills the legacy graphics provenance gap without overriding the ordinary records. No exporter-specific downloader is required.
The manifests preserve each component's source URL, version or revision, observed archive hash where available, file hashes, exclusions and license inventory. Generated dependencies include CMOC, LWTools, mcpp, GNU Make, Perl, guest libraries, the optional CoCo Letters source fixture, the ToolShed filesystem subset and legacy graphics headers. CoCo Letters is a validation fixture, not a bundled game.
CMOC's Float09.bin, dskcon-standalone.c and unqualified USim snapshot remain excluded. Normal public toolchain builds do not need those inputs. Other components retain their original file-specific terms. Building the compiler does not change the license of a program it compiles; linked libraries and distributed executable components retain their applicable notices.
When distributing compiled tools, retain their corresponding source, build patches and required notices together as appropriate to their licenses. Generated source and original archives are local ignored build inputs, not source history in this repository. This distribution uses the shared source build profile and optional SourceToolchainBundle; it does not discover the ordinary maintainer runtime or collection inputs. Developer ID signing, notarization and DMG packaging are outside this source-build workflow.