documented new methods