Story: Skip vcpkg for doc-only cmake builds
Table of Contents
This page documents a story in Sprint 20. It captures the goal, current status, acceptance criteria, and the tasks that compose it.
Goal
Doc-only cmake targets (deploy_site, deploy_skills, deploy_settings,
etc.) should configure and build without triggering vcpkg package
installation. Introduce ORES_VCPKG_ENABLED (default ON) as a cmake
cache variable that gates the entire vcpkg + C++ toolchain setup; a new
linux-doc-only preset flips it OFF. The site CI workflow adopts this
preset, removing the sccache, Qt, and vcpkg setup steps it never needed.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent sprint | Sprint 20 |
| Now | Nothing. |
| Waiting on | Nothing. |
| Next | Nothing. |
| Last touched | 2026-06-12 |
Acceptance
cmake --preset linux-doc-onlycompletes without running vcpkg or installing any packages (configure time ~0.1s).cmake --build --preset linux-doc-only --target deploy_sitebuilds the site successfully.- Normal C++ presets (
linux-clang-debug-ninja, etc.) still find vcpkg packages unchanged. - Site CI (
site-cdash.yml) no longer includes sccache, Qt, or vcpkg steps.
Tasks
| Task | State | Start | End | Description |
|---|---|---|---|---|
| Implement ORES_VCPKG_ENABLED cmake switch | DONE | 2026-06-12 | 2026-06-12 | Add ORES_VCPKG_ENABLED cache variable; move emacs targets before C++ deps; add linux-doc-only preset; switch site-cdash.yml to the new preset. |
Decisions
Out of scope
- Windows or macOS CI site builds (both use separate workflows).
- Expanding the doc-only preset to cover other Emacs targets (manual PDF, help QCH) beyond the site build.