Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

4.0.0: sphinx warnings `reference target not found`

See original GitHub issue

On building my packages I’m using sphinx-build command with -n switch which shows warmings about missing references. These are not critical issues. Here is the output with warnings:

+ /usr/bin/sphinx-build -n -T -b man docs build/sphinx/man
Running Sphinx v4.5.0
making output directory... done
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 7 added, 0 changed, 0 removed
reading sources... [100%] usage
/home/tkloczko/rpmbuild/BUILD/sphinx-click-4.0.0/docs/changelog.rst:4: CRITICAL: Problems with "include" directive path:
InputError: [Errno 2] No such file or directory: 'ChangeLog'.
/home/tkloczko/rpmbuild/BUILD/sphinx-click-4.0.0/docs/examples/commandcollections.rst:18: ERROR: Failed to import "cli" from "commandcollections.cli". The following exception was raised:
Traceback (most recent call last):
  File "/home/tkloczko/rpmbuild/BUILD/sphinx-click-4.0.0/sphinx_click/ext.py", line 379, in _load_module
    mod = __import__(module_name, globals(), locals(), [attr_name])
ModuleNotFoundError: No module named 'commandcollections'
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-sphinx-click.3 { installation usage contributing changelog examples/index examples/commandcollections } /home/tkloczko/rpmbuild/BUILD/sphinx-click-4.0.0/docs/index.rst:4: WARNING: py:mod reference target not found: sphinx_click
/home/tkloczko/rpmbuild/BUILD/sphinx-click-4.0.0/docs/index.rst:24: WARNING: py:mod reference target not found: click
/home/tkloczko/rpmbuild/BUILD/sphinx-click-4.0.0/docs/index.rst:23: WARNING: py:mod reference target not found: click
/home/tkloczko/rpmbuild/BUILD/sphinx-click-4.0.0/docs/index.rst:26: WARNING: py:mod reference target not found: sphinxcontrib.autoprogram
/home/tkloczko/rpmbuild/BUILD/sphinx-click-4.0.0/docs/index.rst:27: WARNING: py:mod reference target not found: argparse
done
build succeeded, 7 warnings.

Issue Analytics

State:
Created a year ago
Comments:7 (4 by maintainers)

Top GitHub Comments

1reaction

stephenfincommented, Apr 26, 2022

Oh, wait, you’re referring to the docs for this project. Apologies. I’ll take a look now

0reactions

kloczekcommented, Apr 27, 2022

Thank you 😄

Top Results From Across the Web

4.0.0: sphinx warnings reference target not found #252 - GitHub

On building my packages I'm using sphinx-build command with -n switch which shows warmings about missing references. These are not critical ...

Sphinx autodoc gives WARNING: py:class reference target not ...

This is simply a bug in the Python docs themselves--references to some of the Python built-ins (including type ) do no resolve correctly...

Changelog - Sphinx documentation

To migrate: either add an explicit inventory name to the references intersphinx should resolve, or explicitly set the value of this configuration variable ......

sphinx Changelog - pyup.io

9577, 10088: py domain: Fix warning for duplicate Python references when ... 10534: Missing CSS for nav.contents in Docutils 0.18+. Patch by Adam...

sphinx.pdf - Read the Docs

Any cross-reference that has no matching target ... If it not already present, this will install Python for you.