ipython/ipython — pull request #2616 by takluyver (2012-11-24 17:24:37+00:00)
Title: Revamp API docs

This makes the API docs shorter and (hopefully) more useful.

- Don't add inheritance diagrams to all modules. I've manually added them to the docstrings where I think they're useful.
- Don't include undocumented and inherited members in class documentation. Links to base classes are still included.
- Use fewer subheadings, so the overview on [this page](http://ipython.org/ipython-doc/dev/api/index.html) is shorter. Classes can still be found in the index.
- Add an `@undoc` decorator to exclude classes and functions from the documentation.

Alternative to #2383. This should require much less manual maintenance than that one would.