Need to fix up sphinx warnings, etc.

Sphinx gives a boatload of warnings each time we build (e.g. https://travis-ci.org/astropy/astroquery/jobs/11808153).  These don't cause any major problems I'm aware of, but they should still be cleaned up