2.4.0: sphinx warnings about `reference target not found`

[kloczek]

trafficstars

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] 16 added, 0 changed, 0 removed
reading sources... [100%] sortedset
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-sortedcontainers.3 { introduction performance performance-load performance-runtime performance-workload performance-scale development implementation history sortedlist sorteddict sortedset pycon-2016-talk sf-python-2015-lightning-talk djangocon-2015-lightning-talk } /home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/docs/introduction.rst:698: WARNING: py:func reference target not found: SortedList.bisect
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/docs/introduction.rst:775: WARNING: py:func reference target not found: SortedDict.irange
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/docs/performance-load.rst:324: WARNING: py:func reference target not found: iter(SortedSet)
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/docs/performance-runtime.rst:320: WARNING: py:func reference target not found: iter(SortedSet)
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/docs/performance-workload.rst:137: WARNING: py:func reference target not found: SortedList.bisect
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/docs/performance-workload.rst:154: WARNING: py:func reference target not found: SortedList.bisect
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/docs/performance-scale.rst:10: WARNING: py:func reference target not found: SortedList.add
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/docs/performance-scale.rst:10: WARNING: py:func reference target not found: SortedList.__delitem__
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/docs/performance-scale.rst:36: WARNING: py:func reference target not found: SortedList.add
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/docs/performance-scale.rst:129: WARNING: py:func reference target not found: SortedList.__delitem__
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/docs/development.rst:220: WARNING: py:class reference target not found: SortedList
HISTORY.rst:161: WARNING: py:func reference target not found: SortedList.bisect
HISTORY.rst:176: WARNING: py:func reference target not found: SortedKeyList.add
HISTORY.rst:177: WARNING: py:func reference target not found: SortedKeyList.__contains__
HISTORY.rst:178: WARNING: py:func reference target not found: SortedKeyList.discard
HISTORY.rst:179: WARNING: py:func reference target not found: SortedKeyList.remove
HISTORY.rst:180: WARNING: py:func reference target not found: SortedKeyList.bisect_left
HISTORY.rst:181: WARNING: py:func reference target not found: SortedKeyList.bisect_right
HISTORY.rst:182: WARNING: py:func reference target not found: SortedKeyList.bisect
HISTORY.rst:183: WARNING: py:func reference target not found: SortedKeyList.count
HISTORY.rst:184: WARNING: py:func reference target not found: SortedKeyList.append
HISTORY.rst:184: WARNING: py:func reference target not found: SortedKeyList.add
HISTORY.rst:186: WARNING: py:func reference target not found: SortedKeyList.extend
HISTORY.rst:186: WARNING: py:func reference target not found: SortedKeyList.update
HISTORY.rst:188: WARNING: py:func reference target not found: SortedKeyList.insert
HISTORY.rst:188: WARNING: py:func reference target not found: SortedKeyList.add
HISTORY.rst:190: WARNING: py:func reference target not found: SortedKeyList.index
HISTORY.rst:191: WARNING: py:func reference target not found: SortedKeyList.__add__
HISTORY.rst:192: WARNING: py:func reference target not found: SortedKeyList.__radd__
HISTORY.rst:193: WARNING: py:func reference target not found: SortedKeyList.__iadd__
HISTORY.rst:194: WARNING: py:func reference target not found: SortedKeyList.__mul__
HISTORY.rst:195: WARNING: py:func reference target not found: SortedKeyList.__rmul__
HISTORY.rst:196: WARNING: py:func reference target not found: SortedKeyList.__imul__
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/sortedcontainers/sortedlist.py:docstring of sortedcontainers.sortedlist.SortedList:1: WARNING: py:class reference target not found: collections.abc.MutableSequence
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/sortedcontainers/sorteddict.py:docstring of sortedcontainers.sorteddict.SortedKeysView:1: WARNING: py:class reference target not found: collections.abc.KeysView
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/sortedcontainers/sorteddict.py:docstring of sortedcontainers.sorteddict.SortedKeysView:1: WARNING: py:class reference target not found: collections.abc.Sequence
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/sortedcontainers/sorteddict.py:docstring of sortedcontainers.sorteddict.SortedItemsView:1: WARNING: py:class reference target not found: collections.abc.ItemsView
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/sortedcontainers/sorteddict.py:docstring of sortedcontainers.sorteddict.SortedItemsView:1: WARNING: py:class reference target not found: collections.abc.Sequence
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/sortedcontainers/sorteddict.py:docstring of sortedcontainers.sorteddict.SortedValuesView:1: WARNING: py:class reference target not found: collections.abc.ValuesView
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/sortedcontainers/sorteddict.py:docstring of sortedcontainers.sorteddict.SortedValuesView:1: WARNING: py:class reference target not found: collections.abc.Sequence
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/sortedcontainers/sortedset.py:docstring of sortedcontainers.sortedset.SortedSet:1: WARNING: py:class reference target not found: collections.abc.MutableSet
/home/tkloczko/rpmbuild/BUILD/python-sortedcontainers-2.4.0/sortedcontainers/sortedset.py:docstring of sortedcontainers.sortedset.SortedSet:1: WARNING: py:class reference target not found: collections.abc.Sequence
done
build succeeded, 42 warnings.

[grantjenks]

Are these links broken on the docs site? Might just be your build.

[kloczek]

On top you have exact command which you may ececute to reproduce that issue and version of the sphinx which I'm using. Please try to repruce that issue.

[grantjenks]

I recently updated the docs without issue.

[kloczek]

Did you try to execute sphinx-build with -n option?