fix javadoc errors which were stopping build

Hi.

The greater than signs in the java comments were causing the gradle build to fail.
I adjusted them, and got rid of a couple of other complaints the javadoc stage was complaining about. 
(empty <p></p> spots mainly).