document new parameters