Documentation fails to specify sphinx requirement and graphviz requirement.

[Richard Wackerbarth]

Sphinx is required to build the documentation.
However, it is not automatically installed
and the installation documentation fails to instruct that it be installed before building the online docs.

[Mark Sapiro (msapiro)]

How does one build the docs with sphinx installed?

src/mailman/docs/START.rst says run "python setup.py build_sphinx" but that doesn't work. It says build_sphinx is an unknown command. "python setup.py build" runs, but doesn't build the docs.

I tried "python conf.py build_sphinx" and all it did was make a symlink from build/sphinx/html/index.html to README.html which doesn't exist.

(this is with the current head - rev 7149 - of the branch)

[Mark Sapiro (msapiro)]

Regarding my question above, with Richard Wackerbarth's help, I have resolved my issue. The issue is that if one is running in an active virtualenv, with sphinx installed globally but not in the virtualenv, you have to either install sphinx in the virtualenv or run setup with the global python, e.g. '/usr/bin/python setup.py build_sphinx'.

[Mark Sapiro (msapiro)]

In addition to the requirement for sphinx, the src/mailman/docs/8-miles-high.rst document uses the sphinx graphviz extension and requires that at least the 'dot' command (part of graphviz) be installed somewhere in the current path.

[Staffan Ericsson (staffan-ericsson)]

For ubuntu there is the package python-sphinx.

So apt-get install python-sphinx enables "python setup.py build_sphinx" to run correctly.

[Abhilash Raj (raj-abhilash1)]

This bug has been moved to the new gitlab repo here: https://gitlab.com/mailman/mailman/issues/12