add javadoc for retrieveMessages() methods