Skip to content

fix(doc): configure to fetch stela/indep sources before doxygen - #66

Merged
kniz merged 2 commits into
mainfrom
fix/doc-populate-deps-before-doxygen
Sep 6, 2026
Merged

kniz merged 2 commits into
mainfrom
fix/doc-populate-deps-before-doxygen

Conversation

@kniz-bot

@kniz-bot kniz-bot commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #63, addressing the Codex review comment ("Populate fetched sources before generating reference docs").

Problem

#63 pointed the doxygen INPUT at _deps/stela_dep-src/... and _deps/indep_dep-src/..., but those directories are created only by FetchContent_MakeAvailable during CMake configure. builder.py doc (and the publish-doc CI job) runs doxygen on a clean tree without configuring or building, so on every documentation run both inputs are absent and the stela/indep API pages are still omitted — the exact regression #63 meant to fix.

Fix

doc() now runs a CMake configure before doxygen when _deps is missing, reusing the existing FetchContent declarations (no duplicated repo/tag — a single configure resolves the transitive stela → indep fetch). It is skipped when _deps/{stela,indep}_dep-src already exist, so repeat/local runs stay fast. builder.py is the only change; the CI job already invokes builder.py doc and has cmake/flex/bison installed.

Verification

On a clean tree (_deps absent), a configure now creates exactly the referenced inputs:

_deps/stela_dep-src/module/{clog,meta,memlite,stela}
_deps/indep_dep-src/module/indep

🤖 Generated with Claude Code

The reference INPUT points at _deps/{stela,indep}_dep-src, which only CMake FetchContent creates at configure time. doc ran doxygen without configuring, so the clean publish-doc runner had neither directory and the stela/indep API pages stayed empty despite #63's path fix. doc() now configures once (skipping when _deps already exists) so the fetched sources are present.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@codecov

codecov Bot commented Sep 5, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@kniz
kniz merged commit e7cf467 into main Sep 6, 2026
6 checks passed
@kniz
kniz deleted the fix/doc-populate-deps-before-doxygen branch September 6, 2026 03:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants