add explaination to javadoc