scikits-image/scikits-image — pull request #150 by tonysyu (2012-02-22 03:38:53+00:00)
Title: Sphinx toctrees

Sphinx warnings not addressed in this PR:

* I couldn't figure out where plot_coins_segmentation.py was generated in `ext/gen_rst.py`, so there's still a toctree warning for that.

* There's a 'contents.txt' file in the source directory that I don't believe is part of the html build, but may be part of the pdf build.

* There're tons of warnings for the auto-generated api files. Apparently, I tried to fix this last summer (http://mail.scipy.org/pipermail/numpy-discussion/2011-July/057685.html) and supposedly there's a fix for this (http://projects.scipy.org/numpy/ticket/1772), but I can't quite find it.

* I didn't get around to fixing the "image file not readable" errors. As mentioned in the comments of PR #148, this can be fixed, but requires a rearrangement of where the example directory is relative to the source directory (where the tutorial is located). I think I'll skip this fix for this pull request.

* There are "No classes found for inheritance diagram" warnings, which I don't really want to look into right now.

* I recently started a project and wanted an example gallery so I stole the skimage gallery generator. I ended up refactoring it, and may want to add it as a replacement to the current gallery generator (https://github.com/tonysyu/mpltools/blob/master/doc/ext/plot2rst.py).

* Sorry, this PR description is way too long.