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>
@andrewpalumbo - probably no use of storing. I think I wasn't sure about that while coding. Let me remove it.