#44: updated javadocs