javadocs for the above methods