The current documentation on these methods, where present, is more confusing than helpful. Ideally it should be clear which scenarios you should call each method for.