Improving readability by adding docstrings

Description

While reading through the codebase in preparation for writing my GSOC 2015 application, I added docstrings to many (not quite all) functions which lacked them.

Also, I changed one function to use the variable name rdr instead of reader to be consistent with the rest of the project.

Environment

N/A

Status

Assignee

Nicola Mometto

Reporter

Matthew West

Approval

None

Patch

Code

Priority

Trivial
Configure