fixed remaining public API javadocs - closes #75