0.971: sphinx warnings `reference target not found`

[kloczek]

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 v5.0.2
making output directory... done
loading intersphinx inventory from https://docs.python.org/3/objects.inv...
loading intersphinx inventory from https://six.readthedocs.io/objects.inv...
loading intersphinx inventory from http://www.attrs.org/en/stable/objects.inv...
loading intersphinx inventory from http://docs.cython.org/en/latest/objects.inv...
loading intersphinx inventory from https://monkeytype.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://setuptools.readthedocs.io/en/latest/objects.inv...
intersphinx inventory has moved: http://www.attrs.org/en/stable/objects.inv -> https://www.attrs.org/en/stable/objects.inv
intersphinx inventory has moved: https://setuptools.readthedocs.io/en/latest/objects.inv -> https://setuptools.pypa.io/en/latest/objects.inv
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 37 added, 0 changed, 0 removed
reading sources... [100%] type_narrowing
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-mypy.3 { getting_started existing_code cheat_sheet_py3 cheat_sheet builtin_types type_inference_and_annotations kinds_of_types class_basics runtime_troubles protocols dynamic_typing python2 type_narrowing duck_type_compatibility stubs generics more_types literal_types final_attrs metaclasses running_mypy command_line config_file inline_config mypy_daemon installed_packages extending_mypy stubgen stubtest common_issues supported_python_features error_codes error_code_list error_code_list2 additional_features faq } /home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/class_basics.rst:218: WARNING: unknown document: library/abc
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/runtime_troubles.rst:66: WARNING: py:func reference target not found: typing.NewType
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/runtime_troubles.rst:240: WARNING: py:meth reference target not found: __class_getitem__
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/type_narrowing.rst:19: WARNING: py:func reference target not found: type
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/more_types.rst:4: WARNING: py:func reference target not found: typing.NewType
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/more_types.rst:14: WARNING: py:func reference target not found: typing.NewType
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/more_types.rst:86: WARNING: py:func reference target not found: typing.NewType
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/more_types.rst:125: WARNING: py:func reference target not found: typing.NewType
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/more_types.rst:130: WARNING: py:func reference target not found: typing.NewType
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/more_types.rst:150: WARNING: py:func reference target not found: typing.NewType
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/more_types.rst:150: WARNING: py:func reference target not found: typing.NewType
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/more_types.rst:155: WARNING: py:func reference target not found: typing.NewType
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/more_types.rst:155: WARNING: py:func reference target not found: typing.NewType
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/more_types.rst:172: WARNING: py:func reference target not found: typing.NewType
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/literal_types.rst:409: WARNING: py:class reference target not found: enum.StrEnum
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/error_code_list.rst:570: WARNING: py:func reference target not found: typing.NewType
/home/tkloczko/rpmbuild/BUILD/mypy-0.971/docs/source/additional_features.rst:142: WARNING: py:class reference target not found: attr.Factory
done
build succeeded, 17 warnings.

You can peak on fixes that kind of issues in other projects
latchset/jwcrypto#289
click-contrib/sphinx-click@abc31069
latchset/jwcrypto#289
RDFLib/rdflib-sqlalchemy#95
sissaschool/elementpath@bf869d9e
jaraco/cssutils#21
pywbem/pywbem#2895
sissaschool/xmlschema@42ea98f2
RDFLib/rdflib#2036
frostming/unearth#14

[emmatyping]

I would be happy to review a PR to make mypy's docs build pass with -n but I don't think we build with it by default.

[kloczek]

Without fixed those warning sphinx cannot add on documentation symbols links and instead higlits those prases.