Documentation improvements.

Added a bit about how to read the source code, deleted the TODO file
and removed an unused #define.