Updated some of the internal documentation (comments, etc) to better describe what the code is (supposed to be) doing, known issues, and stuff that is to be done. Still needs more work, but it is much more up to date and more complete now.
