This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author Daniel.Ellis
Recipients Daniel.Ellis, eric.araujo, ezio.melotti, ncoghlan
Date 2012-08-09.17:36:07
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1344533769.31.0.609415214451.issue15605@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2012-08-09 17:36:09Daniel.Ellissetrecipients: + Daniel.Ellis, ncoghlan, ezio.melotti, eric.araujo
2012-08-09 17:36:09Daniel.Ellissetmessageid: <1344533769.31.0.609415214451.issue15605@psf.upfronthosting.co.za>
2012-08-09 17:36:08Daniel.Ellislinkissue15605 messages
2012-08-09 17:36:07Daniel.Elliscreate