Change validate routine to a single return and a few other documentation...

... changes for Sphinx.