inserts code from a file: .. literalinclude:: example.py

sphinx-build -b html . ./_build

sphinx-build -b html . ./.build or make html

notes on installing Sphinx from source:

#2009.09.04 09:57:32 charles@context:/media/C/downloads/python/sphinx tar zxvf docutils-0.5.tar.gz

python setup.py install sudo python setup.py install

cd ../pygments/ sudo python setup.py install

cd ../jinja2/ sudo python setup.py install

cd ../sphinx sudo python setup.py install

adapted from: | http://pylonsbook.com/en/1.0/documentation.html

once sphinx is installed initialize a new project with:

cd [project]/docs mv index.txt index.txt.orig sphinx-quickstart

.txt for extension yes to autodoc

looks like pyglet api docs used epydoc

this is a good one | http://pylonsbook.com/en/1.0/documentation.html

cd /c/clients/srl/

also downloaded to (see also) /charles/downloads/reference/mako-documentation.html