From ndbecker2 at gmail.com Wed Feb 27 15:33:41 2008 From: ndbecker2 at gmail.com (Neal Becker) Date: Wed, 27 Feb 2008 09:33:41 -0500 Subject: [Doc-SIG] Using doctools Message-ID: I grabbed doctools svn. setup.py install on python-2.5.2 went OK. Sphinx sounds nifty. I looked at http://docs.python.org/dev/documenting/sphinx.html. I don't see any instructions on how to use it. I'm guessing I could use it on my own code, but how? From g.brandl at gmx.net Fri Feb 29 19:17:36 2008 From: g.brandl at gmx.net (Georg Brandl) Date: Fri, 29 Feb 2008 19:17:36 +0100 Subject: [Doc-SIG] Using doctools In-Reply-To: References: Message-ID: Neal Becker schrieb: > I grabbed doctools svn. setup.py install on python-2.5.2 went OK. > > Sphinx sounds nifty. I looked at > http://docs.python.org/dev/documenting/sphinx.html. I don't see any > instructions on how to use it. I'm guessing I could use it on my own code, > but how? You've hit a weak point of sphinx... there's next to no documentation, except what's needed for the Python core docs (mostly the markup). I'll try to get sphinx into a releaseable status soon, with documentation and a few other loose ends I want to fix before. In the meantime just mail me directly -- I'll try to help as much as I can. 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.