Open esabol opened 1 year ago
Similar issue occurred with the Linux kernel documentation. This thread is worth reading:
https://lore.kernel.org/all/564cbd05-8788-9223-1ecc-59e7fc41b46a@gmail.com/
Some of the warnings seem to stem from structs/typedefs/enums/functions having the same name. The solution seems to be to add different sphinx-doc namespaces to them. I'm not sure how to do that yet though. More research (or help) needed.
It's possible some of these warnings might go away on their own if the sphinx-doc developers would ever merge this 3-year-old PR: https://github.com/sphinx-doc/sphinx/pull/8313
Sphinx v1.8.5 on Ubuntu 20.04 works fine as it always has, but Sphinx v4.3.2 on Ubuntu 22.04 and v5.3.0 on Alpine 3.17 emit the following warnings (actually one is an error!):
It would be nice to clean these up, but I have no experience with Sphinx. Anyone have a clue?