Documentation fails to specify sphinx requirement and graphviz requirement.
Bug #975670 reported by
Richard Wackerbarth
This bug affects 2 people
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
GNU Mailman |
Triaged
|
High
|
Unassigned |
Bug Description
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.
tags: | added: mailman3 |
Changed in mailman: | |
status: | New → Triaged |
importance: | Undecided → High |
To post a comment you must log in.
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)