sudo easy_install sphinx

cd /c/moments/docs/
sphinx-build -b html . ./_build

http://sphinx.pocoo.org/
Overview — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/contents.html
Sphinx documentation contents — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/intro.html
Introduction — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/search.html?q=module+API+documentation
Search — Sphinx v0.6.3 documentation
http://en.wikipedia.org/wiki/Sphinx_(documentation_generator)
Sphinx (documentation generator) - Wikipedia, the free encyclopedia
http://broadcast.oreilly.com/2009/02/writing-technical-documentatio.html
Writing Technical Documentation with Sphinx, Paver, and Cog - O'Reilly Broadcast
http://nedbatchelder.com/code/cog/
Ned Batchelder: Cog
http://sphinx.pocoo.org/ext/autodoc.html?highlight=module%20api%20documentation
sphinx.ext.autodoc – Include documentation from docstrings — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/contents.html
Sphinx documentation contents — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/intro.html
Introduction — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/concepts.html
Sphinx concepts — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/rest.html#hyperlinks
reStructuredText Primer — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/markup/index.html
Sphinx Markup Constructs — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/markup/inline.html#cross-referencing-syntax
Inline markup — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/builders.html
Available builders — Sphinx v0.6.3 documentation
http://www.google.com/search?q=sphinx+autodoc&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en-US:official&client=firefox-a
sphinx autodoc - Google Search
http://yml-blog.blogspot.com/2009/06/sphinx-autodoc-and-django-app.html
Blog Roll: sphinx autodoc and django app
http://pylonsbook.com/en/1.0/documentation.html
Chapter 13: Documentation — Pylons Book v1.0 documentation
http://sphinx.pocoo.org/ext/autodoc.html
sphinx.ext.autodoc – Include documentation from docstrings — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/markup/desc.html#dir-function
Module-specific markup — Sphinx v0.6.3 documentation
http://en.wikipedia.org/wiki/HTML
HTML - Wikipedia, the free encyclopedia

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

http://www.google.com/search?hl=en&safe=off&client=firefox-a&channel=s&rls=org.mozilla%3Aen-US%3Aofficial&hs=CHW&q=restructured+text+insert+text&aq=f&oq=&aqi=
restructured text insert text - Google Search
http://www.google.com/search?q=sphinx+insert+code&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en-US:official&client=firefox-a
sphinx insert code - Google Search
http://broadcast.oreilly.com/2009/02/writing-technical-documentatio.html
Writing Technical Documentation with Sphinx, Paver, and Cog - O'Reilly Broadcast
http://www.google.com/search?q=sphinx+include+sample+code&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en-US:official&client=firefox-a
sphinx include sample code - Google Search
http://sphinx.pocoo.org/rest.html
reStructuredText Primer — Sphinx v0.6.3 documentation
http://sphinx.pocoo.org/markup/code.html
Showing code examples — Sphinx v0.6.3 documentation

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

http://prdownloads.sourceforge.net/docutils/docutils-0.5.tar.gz?download
hg clone http://bitbucket.org/birkenfeld/sphinx/
hg clone http://dev.pocoo.org/hg/pygments-main pygments
hg clone http://dev.pocoo.org/hg/jinja2-main jinja2

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

http://sphinx.pocoo.org/
Overview — Sphinx v0.6.2 documentation
http://sphinx.pocoo.org/contents.html
Sphinx documentation contents — Sphinx v0.6.2 documentation
http://sphinx.pocoo.org/intro.html
Introduction — Sphinx v0.6.2 documentation
http://sphinx.pocoo.org/search.html?q=module+API+documentation
Search — Sphinx v0.6.2 documentation
http://www.google.com/search?hl=en&safe=off&client=firefox-a&rls=org.mozilla:en-US:official&ei=ndyWSqTrJIimlAfUqcyTDA&sa=X&oi=spell&resnum=0&ct=result&cd=1&q=sphinx+documentation+from+source+code&spell=1
sphinx documentation from source code - Google Search
http://git.savannah.gnu.org/cgit/kenozooid.git/tree/doc/extapi.py
kenozooid.git -
http://en.wikipedia.org/wiki/Sphinx_(documentation_generator)
Sphinx (documentation generator) - Wikipedia, the free encyclopedia
http://broadcast.oreilly.com/2009/02/writing-technical-documentatio.html
Writing Technical Documentation with Sphinx, Paver, and Cog - O'Reilly Broadcast
http://nedbatchelder.com/code/cog/
Ned Batchelder: Cog
http://sphinx.pocoo.org/ext/autodoc.html?highlight=module%20api%20documentation
sphinx.ext.autodoc – Include documentation from docstrings — Sphinx v0.6.2 documentation
http://sphinx.pocoo.org/contents.html
Sphinx documentation contents — Sphinx v0.6.2 documentation
http://sphinx.pocoo.org/concepts.html
Sphinx concepts — Sphinx v0.6.2 documentation
http://sphinx.pocoo.org/markup/index.html
Sphinx Markup Constructs — Sphinx v0.6.2 documentation
http://sphinx.pocoo.org/builders.html
Available builders — Sphinx v0.6.2 documentation
http://sphinx.pocoo.org/rest.html#comments
reStructuredText Primer — Sphinx v0.6.2 documentation
http://www.google.com/search?q=sphinx+autodoc&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en-US:official&client=firefox-a
sphinx autodoc - Google Search
http://yml-blog.blogspot.com/2009/06/sphinx-autodoc-and-django-app.html
Blog Roll: sphinx autodoc and django app
http://pylonsbook.com/en/1.0/documentation.html
Chapter 13: Documentation — Pylons Book v1.0 documentation


http://www.google.com/search?client=firefox-a&rls=org.mozilla%3Aen-US%3Aofficial&channel=s&hl=en&source=hp&q=python+api+documentation+generator&btnG=Google+Search
python api documentation generator - Google Search
http://apydia.ematia.de/learn.html
Apydia - Getting Started
http://www.google.com/search?hl=en&safe=off&client=firefox-a&rls=org.mozilla%3Aen-US%3Aofficial&hs=pER&q=pudge+python&aq=f&oq=&aqi=g-sx1
pudge python - Google Search
http://www.google.com/search?q=apydia+vs+epydoc&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en-US:official&client=firefox-a
apydia vs epydoc - Google Search
http://groups.google.com/group/apydia/browse_thread/thread/bca66d83e96e26f5?fwc=1
Exclude GTK/GObject methods [patch] - Apydia | Google Groups
http://mail.python.org/pipermail/python-list/2007-December/642218.html
pydoc - how to generate documentation for an entire package?
http://mail.python.org/pipermail/python-list/2007-December/639874.html
Generating API documentation as a textfile
http://linux.softpedia.com/catList/192,0,6,0,4.html
Download Documentation - page 4 - Softpedia
http://epydoc.sourceforge.net/
Epydoc
http://epydoc.sourceforge.net/api/
epydoc
http://apydia.ematia.de/apydocs/apydia.html
Apydia API Reference Documentation - Module: apydia
http://www.python.org/community/sigs/current/doc-sig/otherlangs/
Other Documentation Tools
http://stackoverflow.com/questions/1125970/python-documentation-generator
Python documentation generator - Stack Overflow
http://www.packtpub.com/expert-python-programming/book
Expert Python Programming


cd /c/clients/srl/

http://sphinx.pocoo.org/
Overview — Sphinx v0.6.2 documentation
http://sphinx.pocoo.org/contents.html
Sphinx documentation contents — Sphinx v0.6.2 documentation
http://sphinx.pocoo.org/intro.html
Introduction — Sphinx v0.6.2 documentation
http://bitbucket.org/djerdo/musette/src/tip/musette/html/html2rest.py
djerdo / musette / source — bitbucket.org


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

http://www.google.com/search?hl=en&q=mako&btnG=Google+Search&aq=f&oq=
mako - Google Search
http://www.makotemplates.org/
welcome to Mako!
http://www.makotemplates.org/docs/syntax.html#syntax_tags_inherit
Mako Documentation - Syntax
http://www.makotemplates.org/docs/inheritance.html
Mako Documentation - Inheritance
http://www.makotemplates.org/docs/namespaces.html#namespaces_body
Mako Documentation - Namespaces