New submission from Daniel Ellis:
At the bottom of this page: http://docs.python.org/devguide/documenting.html
There is a command explaining how to build the documentation without using make:
python tools/sphinx-build.py -b<builder> . build/<outputdirectory>
It is unclear as to which directory the "tools" is referring to. In the
"Tools" directory of the main branch, there is no sphinx-build.py file.
On my system, I was able to do the build using sphinx-build as a bare command:
sphinx-build -b<builder> . build/<outputdirectory>
I am not sure if this is system specific, but for someone building the
documentation for the first time (as I was), this could be confusing. Perhaps
someone could explain whether the command that is currently written is obsolete
or just differs by system.
----------
components: Devguide
messages: 167800
nosy: Daniel.Ellis, eric.araujo, ezio.melotti, ncoghlan
priority: normal
severity: normal
status: open
title: Explain sphinx documentation building in devguide
_______________________________________
Python tracker <[email protected]>
<http://bugs.python.org/issue15605>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe:
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
