Add some documentation and make adding blocks work on OSX

I've had a lot of fun carefully reading through this project; thank you for it!

This commit series:
- makes adding blocks (right-click detection) work on OSX.
- removes some unused code.
- pulls some of the magic numbers out into constants.
- adds detailed comments around some of the OpenGL settings and game movement calculations.