javadoc improvements - see #65 and #75