closes #15; javadoc