scala cleanup to conform with style guide and scaladoc

Some variable renames, file renames, and some scaladoc created for the
top classes.