updated documentation to reflect the new methods.