- integrations
- CMake
- Everyday
- Everyday guides
Everyday guides
These guides are for a CMake project that already runs a pinned tool and needs to change, freeze or debug what it pins.
Change what the build runs
Section titled “Change what the build runs”- Add or change a pinned tool: edit
ocx.toml, refresh the lock and get the build green for everyone - Pin and freeze tag resolution: fix what
latestmeans and refresh it on purpose - Pin digests instead of a snapshot: fix a tag with a digest and no snapshot directory
- Make the build find provisioned content: point
find_packageandfind_programat what the build fetched
Control which ocx runs
Section titled “Control which ocx runs”- Use an ocx you already installed: prefer the
ocxonPATHand tell which binary a configure runs
Upgrade find_ocx
Section titled “Upgrade find_ocx”- Update the vendored files: move
ocx.cmakeandFindocx.cmaketo another release - Move from 0.3 to 0.4: find every build line the new release breaks
When a configure surprises you
Section titled “When a configure surprises you”- Lazy versus eager: when a configure touches the network and how to force a refresh
- Fix a failing configure: the message, its cause and the fix
- Read an exit code: each code the module reports and what to do next
Go further
Section titled “Go further”The integration guides cover CI, mirrors and offline builds, package mirrors and credentials, cross builds and organisation-wide policy.