port documentation on deprecated functionality