docs for the last of the implemented methods