[NFC] Update doxygen build and configuration files #5718
Conversation
I know that doxygen isn't everyone's favorite thing, but I've found it useful, but it hasn't been updated in a bit. This PR updates it and adds a just ds (doxygen-serve) command to easily serve the generated docs for local browsing. The doxygen build is added because doxygen needs to be built with the correct clang version to avoid warnings and errors.
| the system LLVM/clang installation to enable clang-assisted parsing of C++ code. | ||
| """ | ||
|
|
||
| def _doxygen_repository_impl(ctx): |
There was a problem hiding this comment.
Wot in tarnation... is there really no easier way to build Doxygen from Bazel?
There was a problem hiding this comment.
Would https://github.com/TendTo/rules_doxygen be suitable?
There was a problem hiding this comment.
I have no idea. I didn't try lol. I really dislike dealing with build tooling so went with the easiest thing that could possibly work
There was a problem hiding this comment.
Let's wait to see if Felix agrees, but I'd suggest asking Claude to use rules_doxygen. If it works, there'll be a lot less code.
There was a problem hiding this comment.
Well... if we're going for the easiest thing then doing bazel_dep(name = "rules_doxygen", version = "2.6.1") and following the Use instructions is a lot easier here than this approach. Sometimes we don't need to reinvent the wheel, even if we have automated the reinventing.
There was a problem hiding this comment.
Another vote for rules_doxygen then
There was a problem hiding this comment.
I had tried that approach initially but kept running into issues with the clang support... building the doxygen here was the only way I was able to get it to work reasonably with a couple of the other updates.
|
moving this to draft. there's a few bits to fix up but it's a low priority, will work on it as time allows. |
3 participants
I know that doxygen isn't everyone's favorite thing, but I've found it useful, but it hasn't been updated in a bit. This PR updates it and adds a just ds (doxygen-serve) command to easily serve the generated docs for local browsing.
The doxygen build is added because doxygen needs to be built with the correct clang version to avoid warnings and errors.
I had claude do the bazel bits because I really hate dealing with build systems.