document new methods.