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:
```console
+ /usr/bin/sphinx-build -n -T -b man doc/build build/sphinx/man
Running Sphinx v5.0.2
making output directory... done
WARNING: html_static_path entry 'static' does not exist
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 11 added, 0 changed, 0 removed
reading sources... [100%] usage
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/doc/build/changelog.rst:985: ERROR: Unknown target name: "cache".
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-mako.3 { usage syntax defs runtime namespaces inheritance filtering unicode caching changelog } /home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/doc/build/usage.rst:143: WARNING: py:class reference target not found: TopLevelNotFound
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/doc/build/usage.rst:358: WARNING: py:mod reference target not found: mako.ext.pygmentplugin
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/mako/template.py:docstring of mako.template.Template:170: WARNING: py:class reference target not found: Lexer
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/mako/template.py:docstring of mako.template.Template:170: WARNING: py:class reference target not found: Lexer
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/mako/lookup.py:docstring of mako.lookup.TemplateCollection.get_template:4: WARNING: py:class reference target not found: TemplateLookupException
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/mako/runtime.py:docstring of mako.runtime.LoopContext:7: WARNING: py:attr reference target not found: parent
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/mako/runtime.py:docstring of mako.runtime.LoopContext:9: WARNING: py:attr reference target not found: index
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/mako/runtime.py:docstring of mako.runtime.LoopContext:11: WARNING: py:attr reference target not found: reverse_index
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/mako/runtime.py:docstring of mako.runtime.LoopContext:13: WARNING: py:attr reference target not found: first
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/mako/runtime.py:docstring of mako.runtime.LoopContext:15: WARNING: py:attr reference target not found: last
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/mako/runtime.py:docstring of mako.runtime.LoopContext:17: WARNING: py:attr reference target not found: even
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/mako/runtime.py:docstring of mako.runtime.LoopContext:21: WARNING: py:attr reference target not found: odd
docstring of mako.runtime.Namespace.uri:5: WARNING: py:attr reference target not found: Template.uri
docstring of mako.runtime.TemplateNamespace.uri:5: WARNING: py:attr reference target not found: Template.uri
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/doc/build/caching.rst:136: WARNING: py:class reference target not found: beaker.cache.CacheManager
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/doc/build/caching.rst:225: WARNING: py:mod reference target not found: dogpile.cache.plugins.mako_cache
/home/tkloczko/rpmbuild/BUILD/mako-rel_1_2_1/mako/cache.py:docstring of mako.cache.Cache:13: WARNING: py:attr reference target not found: Template.cache
done
The name of the builder is: manThe name of the builder is: manbuild succeeded, 19 warnings.
```
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:You can peak on fixes that kind of issues in other projects https://github.com/latchset/jwcrypto/pull/289 https://github.com/click-contrib/sphinx-click/commit/abc31069 https://github.com/latchset/jwcrypto/pull/289 https://github.com/RDFLib/rdflib-sqlalchemy/issues/95 https://github.com/sissaschool/elementpath/commit/bf869d9e https://github.com/jaraco/cssutils/issues/21 https://github.com/pywbem/pywbem/pull/2895 https://github.com/sissaschool/xmlschema/commit/42ea98f2