Documentation

Sphinx

We use Sphinx to create the documentation from docstrings in code.

pip install sphinx
pip install sphinxcontrib-napoleon

The Sphinx config is located in docs/conf.py

If new source files are added, auto-create the new rst files:

sphinx-apidoc -o docs/source/modules -T deluge deluge/tests

The manually updated rst files are: - index.rst - The index page for Deluge documentation - docs/source/interfaces/ - User info on the different clients - docs/source/core/ - Documentation of the DelugeRPC

To build the docs:

python setup.py build_docs

Notes

There are two uses of Mock classes for catching/ignoring import errors: - In conf.py it is only applied to modules listed in MOCK_MODULES. - In setup.py it is used for any other ImportError or Exception.

man pages

Located in docs/man