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/source build/sphinx/man
Running Sphinx v4.5.0
making output directory... done
loading intersphinx inventory from https://docs.python.org/3/objects.inv...
loading intersphinx inventory from https://httplib2.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://requests.readthedocs.io/en/master/objects.inv...
loading intersphinx inventory from https://urllib3.readthedocs.io/en/latest/objects.inv...
intersphinx inventory has moved: https://requests.readthedocs.io/en/master/objects.inv -> https://docs.python-requests.org/en/master/objects.inv
[autosummary] generating autosummary for: acks.rst, api.rst, changelog.rst, contributing.rst, guides.rst, index.rst, introduction.rst
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%] introduction
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-httpretty.3 { introduction guides acks api contributing changelog } /home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/introduction.rst:170: WARNING: py:class reference target not found: mock.Mock
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/guides.rst:65: WARNING: py:class reference target not found: st
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httpretty.enable:26: WARNING: py:class reference target not found: httpretty.enabled
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httpretty.disable:18: WARNING: py:meth reference target not found: httpretty.core.reset
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httprettified:3: WARNING: py:func reference target not found: httpretty.activate
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httprettized:3: WARNING: py:func reference target not found: httpretty.enabled
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.Entry:: WARNING: py:class reference target not found: re.Pattern
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.Entry:: WARNING: py:class reference target not found: httpretty.Entry
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.Entry:: WARNING: py:class reference target not found: re.Pattern
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.Entry:: WARNING: py:class reference target not found: httpretty.Entry
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httprettified:3: WARNING: py:func reference target not found: httpretty.activate
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httprettized:3: WARNING: py:func reference target not found: httpretty.enabled
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httpretty.Response:: WARNING: py:class reference target not found: re.Pattern
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httpretty.Response:: WARNING: py:class reference target not found: httpretty.Entry
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httpretty.disable:18: WARNING: py:meth reference target not found: httpretty.core.reset
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httpretty.enable:26: WARNING: py:class reference target not found: httpretty.enabled
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httpretty.match_http_address:3: WARNING: py:class reference target not found: httpretty.core.URLMatcher
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httpretty.match_https_hostname:2: WARNING: py:class reference target not found: httpretty.core.URLMatcher
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/../../httpretty/core.py:docstring of httpretty.core.httpretty.match_uriinfo:2: WARNING: py:class reference target not found: httpretty.core.URLMatcher
/home/tkloczko/rpmbuild/BUILD/HTTPretty-1.1.4/docs/source/changelog.rst:22: WARNING: py:mod reference target not found: urllib3
WARNING: asciinema: unsupported output format (node skipped)
done
build succeeded, 21 warnings.
On building my packages I'm using
sphinx-buildcommand with-nswitch which shows warmings about missing references. These are not critical issues. Here is the output with warnings:You can peak on https://github.com/latchset/jwcrypto/pull/289 https://github.com/click-contrib/sphinx-click/commit/abc31069.