on this page, http://docs.python.org/2/library/pydoc.html, there is no mention of nor explanation of what a docstring is. there is no mention of what formatting conventions docstrings should follow in order for pydoc to work. if there's no single standard then the page should say so explicitly and give pointers to a few of the competing conventions.