add Guardian Project logo and name to javadoc
fix all javadoc warnings and some related improvements