fix some Sphinx warnings

and a teeny bit of copyediting too.