javadocs on both methods