(maint) Add javadoc style comments

Prior to this commit, the java files did not have proper javadoc style
comment syntax. This commit adds that.