0.5.3: 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 build/sphinx/man
Running Sphinx v4.5.0
Creating file api/rdflib_sqlalchemy.rst.
Creating file api/rdflib_sqlalchemy.base.rst.
Creating file api/rdflib_sqlalchemy.constants.rst.
Creating file api/rdflib_sqlalchemy.sql.rst.
Creating file api/rdflib_sqlalchemy.statistics.rst.
Creating file api/rdflib_sqlalchemy.store.rst.
Creating file api/rdflib_sqlalchemy.tables.rst.
Creating file api/rdflib_sqlalchemy.termutils.rst.
Creating file api/rdflib_sqlalchemy.types.rst.
Creating file api/modules.rst.
making output directory... done
loading intersphinx inventory from https://docs.python.org/3/objects.inv...
loading intersphinx inventory from https://rdflib.readthedocs.io/en/stable/objects.inv...
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%] index
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-rdflib-sqlalchemy.3 { api/modules api/rdflib_sqlalchemy api/rdflib_sqlalchemy.base api/rdflib_sqlalchemy.constants api/rdflib_sqlalchemy.sql api/rdflib_sqlalchemy.statistics api/rdflib_sqlalchemy.store api/rdflib_sqlalchemy.tables api/rdflib_sqlalchemy.termutils api/rdflib_sqlalchemy.types } /home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/sql.py:docstring of rdflib_sqlalchemy.sql.union_select:: WARNING: py:class reference target not found: iterable of tuples
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/sql.py:docstring of rdflib_sqlalchemy.sql.union_select:8: WARNING: py:obj reference target not found: COUNT_SELECT
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/sql.py:docstring of rdflib_sqlalchemy.sql.union_select:8: WARNING: py:obj reference target not found: CONTEXT_SELECT
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/sql.py:docstring of rdflib_sqlalchemy.sql.union_select:8: WARNING: py:obj reference target not found: TRIPLE_SELECT
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/statistics.py:docstring of rdflib_sqlalchemy.statistics.get_group_by_count:3: WARNING: py:obj reference target not found: Session
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/statistics.py:docstring of rdflib_sqlalchemy.statistics.get_group_by_count:3: WARNING: py:obj reference target not found: Column
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/store.py:docstring of rdflib_sqlalchemy.store.SQLAlchemy:1: WARNING: py:class reference target not found: rdflib_sqlalchemy.statistics.StatisticsMixin
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/store.py:docstring of rdflib_sqlalchemy.store.SQLAlchemy:: WARNING: py:class reference target not found: sqlalchemy.engine.Engine
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/store.py:docstring of rdflib_sqlalchemy.store.SQLAlchemy:: WARNING: py:class reference target not found: optional
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/store.py:docstring of rdflib_sqlalchemy.store.SQLAlchemy:23: WARNING: py:obj reference target not found: SQLAlchemy.engine.Engine
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/store.py:docstring of rdflib_sqlalchemy.store.SQLAlchemy.open:3: WARNING: py:obj reference target not found: **kwargs
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/types.py:docstring of rdflib_sqlalchemy.types.TermType:1: WARNING: py:class reference target not found: sqlalchemy.sql.type_api.TypeDecorator
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/types.py:docstring of rdflib_sqlalchemy.types.TermType:3: WARNING: py:class reference target not found: TypeDecorator
done
build succeeded, 13 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

[mwatts15]

Thanks! Addressed in develop branch.

[kloczek]

Thank you.
Just tested those two commits 6dad2e7 10722ef.
Still I see some warnings 😋

+ /usr/bin/sphinx-build -n -T -b man docs build/sphinx/man
Running Sphinx v4.5.0
Creating file api/rdflib_sqlalchemy.rst.
Creating file api/rdflib_sqlalchemy.base.rst.
Creating file api/rdflib_sqlalchemy.constants.rst.
Creating file api/rdflib_sqlalchemy.sql.rst.
Creating file api/rdflib_sqlalchemy.statistics.rst.
Creating file api/rdflib_sqlalchemy.store.rst.
Creating file api/rdflib_sqlalchemy.tables.rst.
Creating file api/rdflib_sqlalchemy.termutils.rst.
Creating file api/rdflib_sqlalchemy.types.rst.
Creating file api/modules.rst.
making output directory... done
loading intersphinx inventory from https://docs.python.org/3/objects.inv...
loading intersphinx inventory from https://rdflib.readthedocs.io/en/stable/objects.inv...
loading intersphinx inventory from https://docs.sqlalchemy.org/en/14/objects.inv...
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%] index
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-rdflib-sqlalchemy.3 { api/modules api/rdflib_sqlalchemy api/rdflib_sqlalchemy.base api/rdflib_sqlalchemy.constants api/rdflib_sqlalchemy.sql api/rdflib_sqlalchemy.statistics api/rdflib_sqlalchemy.store api/rdflib_sqlalchemy.tables api/rdflib_sqlalchemy.termutils api/rdflib_sqlalchemy.types } /home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/sql.py:docstring of rdflib_sqlalchemy.sql.union_select:: WARNING: py:class reference target not found: iterable of tuples
/home/tkloczko/rpmbuild/BUILD/rdflib-sqlalchemy-0.5.3/rdflib_sqlalchemy/types.py:docstring of rdflib_sqlalchemy.types.TermType:3: WARNING: py:class reference target not found: TypeDecorator
done
build succeeded, 2 warnings.

[mwatts15]

Oh, I know about those. I just don't think they matter.