document new functionality