* Building docs gives the following error (Sphinx >= 1.0):

    Exception occurred:

       File "/Library/Python/2.6/site-packages/docutils/statemachine.py", line 1193, in __radd__

        raise TypeError('adding ViewList to a non-ViewList')

    TypeError: adding ViewList to a non-ViewList

    This turns out to be a problem in the Sphinx extension, plot_directive.py (see http://projects.scipy.org/numpy/ticket/1489). As a fix, I changed conf.py to import plot_directive from matplotlib.sphinxext. I'm assuming that this isn't ideal since plot_directive must have been forked from matplotlib by numpy to fix-issues and/or add features, but it seems to work for me.

* Auto docs don't work properly (at least on my system) when other scikits are on the python path. Basically, the call to __import__('scikits.image') in apigen.py returns the path to *a different scikit*. A work around is to use the import function shown here: http://stackoverflow.com/questions/211100/pythons-import-doesnt-work-as-expected/211101#211101

* Also, it *might* be a good idea to remove auto-generated API docs when running "make clean". I got a number of Sphinx warnings because of dead links to old classes/functions.

I'm also getting a lot of Sphinx warnings, but it'll take me some time to track them down.

Cheers,

-Tony