I'm interested in trying out new style (python 2.6) documentation. I see we're using docutils + sphinx? I did: svn co http://svn.python.org/projects/doctools/trunk/ How can I install this to try it with python-2.5?
Neal Becker schrieb:
What do you want to try with Python 2.5? If you want to build the Python 2.6/3.0 docs, it's easiest to check the Python sources out from http://svn.python.org/projects/python/trunk, go to the Doc directory and do "make html". This will checkout sphinx and all other needed libraries into Doc/tools and build the docs. Georg -- Thus spake the Lord: Thou shalt indent with four spaces. No more, no less. Four shall be the number of spaces thou shalt indent, and the number of thy indenting shall be four. Eight shalt thou not indent, nor either indent thou two, excepting that thou then proceed to four. Tabs are right out.
Neal Becker schrieb:
I see. Currently, sphinx is not ready to be used by other projects, at least not in conjunction with tools like epydoc. (You should, however, be able to create a rst document hierarchy like Python's and use sphinx for it.) As soon as all needs for the Python documentation are fulfilled, I'll think about how to make the toolset available for other projects. Georg -- Thus spake the Lord: Thou shalt indent with four spaces. No more, no less. Four shall be the number of spaces thou shalt indent, and the number of thy indenting shall be four. Eight shalt thou not indent, nor either indent thou two, excepting that thou then proceed to four. Tabs are right out.
Neal Becker schrieb:
What do you want to try with Python 2.5? If you want to build the Python 2.6/3.0 docs, it's easiest to check the Python sources out from http://svn.python.org/projects/python/trunk, go to the Doc directory and do "make html". This will checkout sphinx and all other needed libraries into Doc/tools and build the docs. Georg -- Thus spake the Lord: Thou shalt indent with four spaces. No more, no less. Four shall be the number of spaces thou shalt indent, and the number of thy indenting shall be four. Eight shalt thou not indent, nor either indent thou two, excepting that thou then proceed to four. Tabs are right out.
Neal Becker schrieb:
I see. Currently, sphinx is not ready to be used by other projects, at least not in conjunction with tools like epydoc. (You should, however, be able to create a rst document hierarchy like Python's and use sphinx for it.) As soon as all needs for the Python documentation are fulfilled, I'll think about how to make the toolset available for other projects. Georg -- Thus spake the Lord: Thou shalt indent with four spaces. No more, no less. Four shall be the number of spaces thou shalt indent, and the number of thy indenting shall be four. Eight shalt thou not indent, nor either indent thou two, excepting that thou then proceed to four. Tabs are right out.
participants (2)
-
Georg Brandl -
Neal Becker