add retrieval javadoc