llnl / llnl/blt

problem with dependencies when make sphinx target

Open
#217 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
C++
Stars
296
Forks
66
Avg merge
1h 3m
Merged PRs (30d)
1

Description

Sometimes when running the sphinx make target generated by blt, modified dependencies appear to miss being reprocessed by sphinx. My basis for this statement is that I can be modifying documentation and running the make target and everything is fine...but if I rerun cmake to regenerate the build directory, I will get errors that I didn't see from previously. Perhaps an option to do a full rebuild would solve this?

https://stackoverflow.com/questions/21019505/sphinx-force-rebuild-of-html-including-autodoc

Contributor guide

Open the contributing guide

Research direction

Start with the Sphinx make target generated by BLT and inspect how its dependencies are handled when documentation changes, then compare that behavior after rerunning CMake to regenerate the build directory. Reproduce the missing reprocessing and verify that modified documentation is handled consistently without requiring an unnecessary full rebuild.

Written by the indexing model from the issue text.

Assessment

Tech stack
cmake, cpp
Domain
build-system, documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.