issue #86 add javadocs