Progress towards complete docstring conversion to reStructuredText

There are still many docstrings scattered throughout the code that are not up to reStructuredText format standards, these can be fixed gradually as I find them.

An issue I want to bring up is how to format any attribute/parameter list for a function and member lists for classes. Should it be in the current style of unordered lists or should I switch them over to definition lists?

http://docutils.sourceforge.net/docs/user/rst/quickref.html#definition-lists

They simply look nicer when rendered and are also clearer to read in the source code.