MAHOUT-1500: Code cleanup

- Add javadoc and scaladoc comments.
- Fix code comment style per standards.
- Fix some more camelCase naming.

Signed-off-by: Anand Avati <avati@redhat.com>