Rewrote comments/documentation.

Just make sure I didn't change the meaning of anything. Enjoy :)