Doc string parameter documentation

[Gustavo Niemeyer]

> In the JFDI model, we should just starting using Sphinx to generate docs
> from docstrings. Wrongly formatted docstrings will still be visible and
> useful, just ugly and lacking conveniences like cross-referencing.

Indeed, but can we please JF have our functional tests running
automatically first? :-)

-- 
Gustavo Niemeyer
http://niemeyer.net
http://niemeyer.net/plus
http://niemeyer.net/twitter
http://niemeyer.net/blog

-- I never filed a patent.