astropy/astropy — pull request #331 by eteq (2012-07-31 08:02:07+00:00)
Title: adds skip option to automodapi to fix sphinx build warnings

This closes #317 but it does a few other, broader things, so I figure it should be a separate PR.

Primarily it *removes* the ``:subpackage:`` option from automodapi, makes a few related adjustments, and adds in a ``:skip:`` option to automodapi and automodsumm. I removed the subpackage option because it is unnecessary now that the heading title ("Reference/API") now lives in the template instead of the automodapi directive itself - it now makes more sense to just `automodapi` each section separately, which is what I've done here where subpackage was previously used.

It may actually be better, moving forward, to remove automodapi altogether and just use automodsumm directly... @taldcroft @mdboom @iguananaut @astrofrog, as people who've set up doc sections already, do you have any opinion whether we should nix automodapi? (either way, this PR should go through to fix the sphinx build warnings and add the ``:skip:`` capability to automodsumm)

I've also ``:skip:``ed the 6 objects in `io.vo` that were causing problems because they were documented in two places. The resulting docs can be seen at http://eteq.github.com/astropy/io/vo/index.html#reference-api (in contrast to the latest build without this PR, at http://astropy.readthedocs.org/en/latest/io/vo/index.html#reference-api ). @mdboom, does this seem alright to you?