Continuing documentation cleanup

Expanding comments in files to provide better descriptions of how
internals work. Continuing exception class name refactoring.