Docstrings

Make the code documentation pass checkdoc, as requested by @bbatsov.

These should definitely be checked and possibly amplified by someone more familiar with the code-base than I, but I think this is an improvement, overall.