Changed some variable names.

Cleaned up some docstrings.  Added some comments that I'll need later because
I won't remember.

Signed-off-by: The Doctor <drwho@virtadpt.net>