re-adding files for comments

Overuse of javadoc comments. Sometimes is cool only to document what's relevant.