Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation fails to build with Sphinx 3.0, works with doxygen #2324

Closed
kekePower opened this issue Apr 7, 2020 · 3 comments
Closed

Documentation fails to build with Sphinx 3.0, works with doxygen #2324

kekePower opened this issue Apr 7, 2020 · 3 comments

Comments

@kekePower
Copy link

Exception occurred:
  File "/usr/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 7171, in _resolve_xref_inner
    assert parentSymbol  # should be there
AssertionError
The full traceback has been saved in /tmp/sphinx-err-u7eh2ihg.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!

Please see the full build log.

@randombit
Copy link
Owner

Confirmed. I don't think this is a problem with our docs and needs to be reported upstream.

@randombit
Copy link
Owner

In sphinx-doc/sphinx#7438 it is noted this only occurs when using parallel builds, and I am seeing the same here. So #2326 disables use of -j when invoking sphinx if the version >= 3.0. Once the bug is fixed in a new version of Sphinx, we can enable -j again for those versions.

@randombit
Copy link
Owner

Fixed now in master, thanks for reporting this and checking the patch

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

No branches or pull requests

2 participants