updated methods descriptions for javadoc
updated methods descriptions for javadoc