problem with dependencies when make sphinx target
- 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
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