add javadoc and remove duplicate API method