Please fix the sphinx documentation

[mb]

Dear maintainer,

while packaging csb43 for Debian the build of the documentation failed with a bunch of errors, see below.

As documentation for this package is important I am reluctant to upload it without documentation. It would be nice if those errors could be fixed at the soonest.

sphinx-build -C doc build/html
Running Sphinx v4.5.0
making output directory... done
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 7 source files that are out of date
updating environment: [new config] 7 added, 0 changed, 0 removed
reading sources... [ 14%] source/converter
reading sources... [ 28%] source/csb
reading sources... [ 42%] source/formats
reading sources... [ 57%] source/homebank
reading sources... [ 71%] source/index
reading sources... [ 85%] source/ofx
reading sources... [100%] source/utils

/<<PKGBUILDDIR>>/doc/source/csb.rst:8: ERROR: Unknown directive type "automodule".

.. automodule:: csb43.csb43
    :members:
/<<PKGBUILDDIR>>/doc/source/csb.rst:14: ERROR: Unknown directive type "autoclass".

.. autoclass:: csb43.csb43.File
    :members:
    :special-members:
/<<PKGBUILDDIR>>/doc/source/csb.rst:18: ERROR: Unknown directive type "autoclass".

.. autoclass:: csb43.csb43.ClosingFile
    :members:
    :special-members:
/<<PKGBUILDDIR>>/doc/source/csb.rst:25: ERROR: Unknown directive type "autoclass".

.. autoclass:: csb43.csb43.Account
    :members:
    :special-members:
/<<PKGBUILDDIR>>/doc/source/csb.rst:29: ERROR: Unknown directive type "autoclass".

.. autoclass:: csb43.csb43.ClosingAccount
    :members:
    :special-members:
/<<PKGBUILDDIR>>/doc/source/csb.rst:36: ERROR: Unknown directive type "autoclass".

.. autoclass:: csb43.csb43.Transaction
    :members:
    :special-members:
/<<PKGBUILDDIR>>/doc/source/csb.rst:43: ERROR: Unknown directive type "autoclass".

.. autoclass:: csb43.csb43.Item
    :members:

....

                                                                                                                                                                                                                                  [38/1923]
.. autoattribute:: csb43.formats.TABLIB_FORMATS
/<<PKGBUILDDIR>>/doc/source/formats.rst:14: ERROR: Unknown directive type "autoattribute".

.. autoattribute:: csb43.formats.DICT_FORMATS
/<<PKGBUILDDIR>>/doc/source/formats.rst:16: ERROR: Unknown directive type "autofunction".

.. autofunction:: csb43.formats.convertFromCsb
/<<PKGBUILDDIR>>/doc/source/formats.rst:18: ERROR: Unknown directive type "autofunction".

.. autofunction:: csb43.formats.convertFromCsb2Dict
/<<PKGBUILDDIR>>/doc/source/formats.rst:20: ERROR: Unknown directive type "autofunction".

.. autofunction:: csb43.formats.convertFromCsb2Tabular
/<<PKGBUILDDIR>>/doc/source/homebank.rst:6: ERROR: Unknown directive type "automodule".

.. automodule:: csb43.homebank
    :members:
/<<PKGBUILDDIR>>/doc/source/homebank.rst:9: ERROR: Unknown directive type "autoclass".

.. autoclass:: csb43.homebank.Transaction
    :members:
    :special-members:
/<<PKGBUILDDIR>>/doc/source/homebank.rst:16: ERROR: Unknown directive type "autofunction".

.. autofunction:: csb43.homebank.converter.convertFromCsb
/<<PKGBUILDDIR>>/doc/source/homebank.rst:18: ERROR: Unknown directive type "autoattribute".

.. autoattribute:: csb43.homebank.converter.PAYMODES
/<<PKGBUILDDIR>>/doc/source/index.rst:6: ERROR: Unknown directive type "automodule".

.. automodule:: csb43
/<<PKGBUILDDIR>>/doc/source/ofx.rst:8: ERROR: Unknown directive type "automodule".

.. automodule:: csb43.ofx
    :members:
    :inherited-members:
/<<PKGBUILDDIR>>/doc/source/ofx.rst:15: ERROR: Unknown directive type "autofunction".

.. autofunction:: csb43.ofx.converter.convertFromCsb
/<<PKGBUILDDIR>>/doc/source/ofx.rst:17: ERROR: Unknown directive type "autoattribute".

.. autoattribute:: csb43.ofx.converter.PAYMODES
/<<PKGBUILDDIR>>/doc/source/utils.rst:6: ERROR: Unknown directive type "automodule".

.. automodule:: csb43.utils
    :members:
    :undoc-members:

‌

[mb]

I see that the documentation has to be built from an environment with csb43 installed which gives me a working documentation tree. There are still left those Warnings:

‌

/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/csb43/csb_file.py:docstring of csb43.csb43.csb_file.File.__init__:4: WARNING: Inline strong start-string without end-string.
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/__init__.py:docstring of csb43.formats.FORMATS:1: WARNING: duplicate object description of csb43.formats.FORMATS, other instance in formats, use :noindex: for one of them
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/__init__.py:docstring of csb43.formats.DICT_FORMATS:1: WARNING: duplicate object description of csb43.formats.DICT_FORMATS, other instance in formats, use :noindex: for one of them
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/formats.py:docstring of csb43.formats.convertFromCsb:1: WARNING: duplicate object description of csb43.formats.convertFromCsb, other instance in formats, use :noindex: for one of them
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/formats.py:docstring of csb43.formats.convertFromCsb2Dict:1: WARNING: duplicate object description of csb43.formats.convertFromCsb2Dict, other instance in formats, use :noindex: for one of them
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/formats.py:docstring of csb43.formats.convertFromCsb2Tabular:1: WARNING: duplicate object description of csb43.formats.convertFromCsb2Tabular, other instance in formats, use :noindex: for one of them
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/homebank/__init__.py:docstring of csb43.homebank.Transaction:1: WARNING: duplicate object description of csb43.homebank.Transaction, other instance in homebank, use :noindex: for one of them
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/homebank/__init__.py:docstring of csb43.homebank.Transaction.amount:1: WARNING: duplicate object description of csb43.homebank.Transaction.amount, other instance in homebank, use :noindex: for one of them
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/homebank/__init__.py:docstring of csb43.homebank.Transaction.category:1: WARNING: duplicate object description of csb43.homebank.Transaction.category, other instance in homebank, use :noindex: for one of them
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/homebank/__init__.py:docstring of csb43.homebank.Transaction.date:1: WARNING: duplicate object description of csb43.homebank.Transaction.date, other instance in homebank, use :noindex: for one of them
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/homebank/__init__.py:docstring of csb43.homebank.Transaction.description:1: WARNING: duplicate object description of csb43.homebank.Transaction.description, other instance in homebank, use :noindex: for one of them
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/homebank/__init__.py:docstring of csb43.homebank.Transaction.info:1: WARNING: duplicate object description of csb43.homebank.Transaction.info, other instance in homebank, use :noindex: for one of them
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/homebank/__init__.py:docstring of csb43.homebank.Transaction.mode:1: WARNING: duplicate object description of csb43.homebank.Transaction.mode, other instance in homebank, use :noindex: for one of them
/home/mathiasb/.virtualenvs/mbs60/lib/python3.10/site-packages/csb43/homebank/__init__.py:docstring of csb43.homebank.Transaction.payee:1: WARNING: duplicate object description of csb43.homebank.Transaction.payee, other instance in homebank, use :noindex: for one of them

‌

[wmj]

commit e2d0842