fix Sphinx documentation under Py3k

Sphinx is more fussy about indentation, unicode, spacing, etc in its
Py3k form. Do some whitespace and formtatting fixes.