renamed and documented new methods