polished a huge docstring turd
a slovenly and jeuvenile commit
moved __add__ up