finish incomplete javadoc for dat method