Documentation done.

No changes to existing code made, except for replacing one use of a
duplicated method. I.E. We had two methods doing the exact same thing, I
replaced the references to one of the methods with references to the
other, and removed the one that is now not used.