search

zopefoundation / BTrees

Other
80 stars 28 forks source link

4.10.0: sphinx warnings `reference target not found` #180

Open kloczek opened 2 years ago

kloczek commented 2 years ago

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 docs build/sphinx/man Running Sphinx v5.0.1 making output directory... done loading intersphinx inventory from https://docs.python.org/3/objects.inv... loading intersphinx inventory from https://persistent.readthedocs.io/en/latest/objects.inv... loading intersphinx inventory from https://zodb.readthedocs.io/en/latest/objects.inv... loading intersphinx inventory from https://zopeinterface.readthedocs.io/en/latest/objects.inv... intersphinx inventory has moved: https://zodb.readthedocs.io/en/latest/objects.inv -> https://zodb.org/en/latest/objects.inv building [mo]: targets for 0 po files that are out of date building [man]: all manpages updating environment: [new config] 5 added, 0 changed, 0 removed reading sources... [100%] overview looking for now-outdated files... none found pickling environment... done checking consistency... done writing... btrees.1 { overview api development changes } /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:108: WARNING: py:obj reference target not found: keys /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:108: WARNING: py:func reference target not found: values /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:108: WARNING: py:func reference target not found: items /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:115: WARNING: py:func reference target not found: keys /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:115: WARNING: py:func reference target not found: values /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:115: WARNING: py:func reference target not found: items /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:115: WARNING: py:func reference target not found: iterkeys /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:115: WARNING: py:func reference target not found: itervalues /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:115: WARNING: py:func reference target not found: iteritems /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:121: WARNING: py:func reference target not found: minKey /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:121: WARNING: py:func reference target not found: maxKey /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:121: WARNING: py:func reference target not found: byValue /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:286: WARNING: py:meth reference target not found: __cmp__ /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:310: WARNING: py:meth reference target not found: __cmp__ /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:314: WARNING: py:meth reference target not found: __cmp__ /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:314: WARNING: py:meth reference target not found: __cmp__ /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:329: WARNING: py:class reference target not found: Mine /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:347: WARNING: py:meth reference target not found: __cmp__ /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:357: WARNING: py:class reference target not found: persistent.PersistentReference /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:357: WARNING: py:class reference target not found: persistent.PersistentReference /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:357: WARNING: py:meth reference target not found: __cmp__ /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:357: WARNING: py:meth reference target not found: __cmp__ /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:357: WARNING: py:class reference target not found: persistent.PersistentReference /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:487: WARNING: py:meth reference target not found: _check /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/overview.rst:491: WARNING: py:meth reference target not found: _check docstring of BTrees.Interfaces.ISetMutable.__iand__:1: WARNING: py:meth reference target not found: set.intersection_update docstring of BTrees.Interfaces.ISetMutable.__ior__:1: WARNING: py:meth reference target not found: set.update docstring of BTrees.Interfaces.ISetMutable.__isub__:1: WARNING: py:meth reference target not found: set.difference_update docstring of BTrees.Interfaces.ISetMutable.isdisjoint:1: WARNING: py:meth reference target not found: set.isdisjoint docstring of BTrees.Interfaces.ISetMutable.discard:1: WARNING: py:meth reference target not found: set.discard docstring of BTrees.Interfaces.ISetMutable.pop:1: WARNING: py:meth reference target not found: set.pop docstring of BTrees.Interfaces.ISetMutable.__ixor__:1: WARNING: py:meth reference target not found: set.symmetric_difference_update docstring of BTrees.Interfaces.IMinimalDictionary.values:1: WARNING: py:mod reference target not found: zope.interface.common.sequence.IMinimalSequence /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.IMerge:3: WARNING: py:meth reference target not found: BTrees.IIBTree.IIBTree.union /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.IMergeIntegerKey:3: WARNING: py:class reference target not found: BTree.IOBTree.IOBTree docstring of BTrees.Interfaces.IMergeIntegerKey.multiunion:8: WARNING: py:meth reference target not found: BTrees.IIBTree.multiunion docstring of BTrees.Interfaces.IMergeIntegerKey.multiunion:12: WARNING: py:meth reference target not found: BTrees.IOBTree.multiunion docstring of BTrees.Interfaces.IMergeIntegerKey.multiunion:19: WARNING: py:meth reference target not found: BTrees.IIBTree.multiunion :1: WARNING: py:class reference target not found: BTrees.Interfaces._IMergeBTreeModule :1: WARNING: py:class reference target not found: BTrees.Interfaces._IMergeBTreeModule :1: WARNING: py:class reference target not found: BTrees.Interfaces._IMergeBTreeModule :1: WARNING: py:class reference target not found: BTrees.Interfaces._IMergeBTreeModule docstring of BTrees.IFBTree.IFBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.IFBTree.IFBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.IFBTree.IFSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.IFBTree.IFTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.IIBTree.IIBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.IIBTree.IIBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.IIBTree.IISet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.IIBTree.IITreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.IOBTree.IOBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.IOBTree.IOBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.IOBTree.IOSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.IOBTree.IOTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.IUBTree.IUBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.IUBTree.IUBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.IUBTree.IUSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.IUBTree.IUTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.LFBTree.LFBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.LFBTree.LFBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.LFBTree.LFSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.LFBTree.LFTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.LLBTree.LLBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.LLBTree.LLBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.LLBTree.LLSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.LLBTree.LLTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.LOBTree.LOBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.LOBTree.LOBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.LOBTree.LOSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.LOBTree.LOTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.LQBTree.LQBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.LQBTree.LQBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.LQBTree.LQSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.LQBTree.LQTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.OIBTree.OIBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.OIBTree.OIBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.OIBTree.OISet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.OIBTree.OITreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.OLBTree.OLBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.OLBTree.OLBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.OLBTree.OLSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.OLBTree.OLTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.OOBTree.OOBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.OOBTree.OOBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.OOBTree.OOSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.OOBTree.OOTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.OQBTree.OQBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.OQBTree.OQBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.OQBTree.OQSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.OQBTree.OQTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.OUBTree.OUBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.OUBTree.OUBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.OUBTree.OUSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.OUBTree.OUTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.QFBTree.QFBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.QFBTree.QFBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.QFBTree.QFSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.QFBTree.QFTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.QLBTree.QLBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.QLBTree.QLBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.QLBTree.QLSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.QLBTree.QLTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.QOBTree.QOBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.QOBTree.QOBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.QOBTree.QOSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.QOBTree.QOTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.QQBTree.QQBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.QQBTree.QQBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.QQBTree.QQSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.QQBTree.QQTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.UFBTree.UFBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.UFBTree.UFBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.UFBTree.UFSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.UFBTree.UFTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.UIBTree.UIBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.UIBTree.UIBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.UIBTree.UISet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.UIBTree.UITreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.UOBTree.UOBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.UOBTree.UOBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.UOBTree.UOSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.UOBTree.UOTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet docstring of BTrees.UUBTree.UUBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree docstring of BTrees.UUBTree.UUBucket:1: WARNING: py:class reference target not found: BTrees._base.Bucket docstring of BTrees.UUBTree.UUSet:1: WARNING: py:class reference target not found: BTrees._base.Set docstring of BTrees.UUBTree.UUTreeSet:1: WARNING: py:class reference target not found: BTrees._base.TreeSet /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/development.rst:5: WARNING: py:obj reference target not found: BTrees /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/development.rst:11: WARNING: py:obj reference target not found: BTrees /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/development.rst:11: WARNING: py:obj reference target not found: BTrees /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/development.rst:52: WARNING: py:obj reference target not found: KEY_TYPE /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/development.rst:72: WARNING: py:obj reference target not found: KEY_TYPE /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/development.rst:72: WARNING: py:obj reference target not found: KEY_TYPE /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/development.rst:72: WARNING: py:obj reference target not found: KEY_TYPE /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/development.rst:178: WARNING: py:obj reference target not found: SetOpTemplate.c /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/development.rst:232: WARNING: py:obj reference target not found: IIBTree /home/tkloczko/rpmbuild/BUILD/BTrees-4.10.0/docs/development.rst:232: WARNING: py:obj reference target not found: OOBTree done build succeeded, 136 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

kloczek commented 2 years ago

I forgot that to be able run sphinx-build command you need small patch like below

--- a/docs/conf.py~     2022-03-09 07:16:48.000000000 +0000
+++ b/docs/conf.py      2022-06-15 12:32:18.847642170 +0000
@@ -14,11 +14,11 @@
 #import sys, os
 import sys
 import os
-import pkg_resources
 # We actually have slightly better results by documenting the
 # C objects right now.
 # os.environ['PURE_PYTHON'] = '1'
-sys.path.append(os.path.abspath('../'))
+sys.path.append(os.path.abspath("../src"))
+import pkg_resources
 rqmt = pkg_resources.require('BTrees')[0]

 # If extensions (or modules to document with autodoc) are in another directory,
icemac commented 2 years ago

@kloczek It would be easier for me as a maintainer to see that your suggested code change works if you would create a pull request, so GitHub Actions can run the tests.

kloczek commented 1 year ago

Here is updated sphinx output against 5.0

+ /usr/bin/sphinx-build -n -T -b man docs build/sphinx/man
Running Sphinx v6.1.3
making output directory... done
loading intersphinx inventory from https://docs.python.org/3/objects.inv...
loading intersphinx inventory from https://persistent.readthedocs.io/en/latest/objects.inv...
loading intersphinx inventory from https://zodb.org/en/latest/objects.inv...
loading intersphinx inventory from https://zopeinterface.readthedocs.io/en/latest/objects.inv...
building [mo]: targets for 0 po files that are out of date
writing output...
building [man]: all manpages
updating environment: [new config] 5 added, 0 changed, 0 removed
reading sources... [ 20%] api
reading sources... [ 40%] changes
reading sources... [ 60%] development
reading sources... [ 80%] index
reading sources... [100%] overview

looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-btrees.3 { overview api development changes } /home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:108: WARNING: py:obj reference target not found: keys
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:108: WARNING: py:func reference target not found: values
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:108: WARNING: py:func reference target not found: items
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:115: WARNING: py:func reference target not found: keys
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:115: WARNING: py:func reference target not found: values
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:115: WARNING: py:func reference target not found: items
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:115: WARNING: py:func reference target not found: iterkeys
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:115: WARNING: py:func reference target not found: itervalues
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:115: WARNING: py:func reference target not found: iteritems
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:121: WARNING: py:func reference target not found: minKey
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:121: WARNING: py:func reference target not found: maxKey
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:121: WARNING: py:func reference target not found: byValue
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:286: WARNING: py:meth reference target not found: __cmp__
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:310: WARNING: py:meth reference target not found: __cmp__
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:314: WARNING: py:meth reference target not found: __cmp__
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:314: WARNING: py:meth reference target not found: __cmp__
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:329: WARNING: py:class reference target not found: Mine
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:347: WARNING: py:meth reference target not found: __cmp__
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:357: WARNING: py:class reference target not found: persistent.PersistentReference
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:357: WARNING: py:class reference target not found: persistent.PersistentReference
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:357: WARNING: py:meth reference target not found: __cmp__
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:357: WARNING: py:meth reference target not found: __cmp__
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:357: WARNING: py:class reference target not found: persistent.PersistentReference
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:487: WARNING: py:meth reference target not found: _check
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/overview.rst:491: WARNING: py:meth reference target not found: _check
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.ISetMutable:1: WARNING: py:meth reference target not found: set.intersection_update
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.ISetMutable:1: WARNING: py:meth reference target not found: set.update
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.ISetMutable:1: WARNING: py:meth reference target not found: set.difference_update
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.ISetMutable:1: WARNING: py:meth reference target not found: set.isdisjoint
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.ISetMutable:1: WARNING: py:meth reference target not found: set.discard
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.ISetMutable:1: WARNING: py:meth reference target not found: set.pop
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.ISetMutable:1: WARNING: py:meth reference target not found: set.symmetric_difference_update
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.IMinimalDictionary:1: WARNING: py:mod reference target not found: zope.interface.common.sequence.IMinimalSequence
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.IMerge:1: WARNING: py:meth reference target not found: BTrees.IIBTree.IIBTree.union
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/<autodoc>:1: WARNING: py:class reference target not found: BTree.IOBTree.IOBTree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.IMergeIntegerKey:2: WARNING: py:meth reference target not found: BTrees.IIBTree.multiunion
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/<autointerface>:1: WARNING: py:meth reference target not found: BTrees.IOBTree.multiunion
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.Interfaces.IMergeIntegerKey.multiunion:6: WARNING: py:meth reference target not found: BTrees.IIBTree.multiunion
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.IIntegerObjectBTreeModule:1: WARNING: py:class reference target not found: BTrees.Interfaces._IMergeBTreeModule
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.IObjectIntegerBTreeModule:1: WARNING: py:class reference target not found: BTrees.Interfaces._IMergeBTreeModule
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.IIntegerIntegerBTreeModule:1: WARNING: py:class reference target not found: BTrees.Interfaces._IMergeBTreeModule
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/src/BTrees/Interfaces.py:docstring of BTrees.Interfaces.IIntegerFloatBTreeModule:1: WARNING: py:class reference target not found: BTrees.Interfaces._IMergeBTreeModule
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IFBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IFBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IFBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IFBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IIBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IIBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IIBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IIBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IOBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IOBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IOBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IOBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IUBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IUBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IUBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.IUBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LFBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LFBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LFBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LFBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LLBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LLBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LLBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LLBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LOBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LOBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LOBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LOBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LQBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LQBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LQBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.LQBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OIBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OIBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OIBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OIBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OLBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OLBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OLBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OLBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OOBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OOBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OOBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OOBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OQBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OQBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OQBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OQBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OUBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OUBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OUBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.OUBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QFBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QFBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QFBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QFBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QLBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QLBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QLBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QLBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QOBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QOBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QOBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QOBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QQBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QQBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QQBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.QQBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UFBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UFBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UFBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UFBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UIBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UIBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UIBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UIBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UOBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UOBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UOBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UOBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UUBTree:1: WARNING: py:class reference target not found: BTrees._base.Tree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UUBTree:1: WARNING: py:class reference target not found: BTrees._base.Bucket
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UUBTree:1: WARNING: py:class reference target not found: BTrees._base.Set
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docstring of BTrees.UUBTree:1: WARNING: py:class reference target not found: BTrees._base.TreeSet
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/development.rst:5: WARNING: py:obj reference target not found: BTrees
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/development.rst:11: WARNING: py:obj reference target not found: BTrees
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/development.rst:11: WARNING: py:obj reference target not found: BTrees
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/development.rst:52: WARNING: py:obj reference target not found: KEY_TYPE
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/development.rst:72: WARNING: py:obj reference target not found: KEY_TYPE
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/development.rst:72: WARNING: py:obj reference target not found: KEY_TYPE
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/development.rst:72: WARNING: py:obj reference target not found: KEY_TYPE
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/development.rst:178: WARNING: py:obj reference target not found: SetOpTemplate.c
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/development.rst:232: WARNING: py:obj reference target not found: IIBTree
/home/tkloczko/rpmbuild/BUILD/BTrees-5.0/docs/development.rst:232: WARNING: py:obj reference target not found: OOBTree
done
build succeeded, 136 warnings.

You can peak on fixes that kind of issues in other projects https://github.com/RDFLib/rdflib-sqlalchemy/issues/95 https://github.com/RDFLib/rdflib/pull/2036 https://github.com/click-contrib/sphinx-click/commit/abc31069 https://github.com/frostming/unearth/issues/14 https://github.com/jaraco/cssutils/issues/21 https://github.com/latchset/jwcrypto/pull/289 https://github.com/latchset/jwcrypto/pull/289 https://github.com/pypa/distlib/commit/98b9b89f https://github.com/pywbem/pywbem/pull/2895 https://github.com/sissaschool/elementpath/commit/bf869d9e