This change will deprecate Database.add_son_manipulator, and soft deprecate the manipulate options for find() and find_one(). None of the new CRUD write methods (see PYTHON-821) support a manipulate option. The existing CRUD write methods that support manipulate are being deprecated (also PYTHON-821).

We intend to introduce a replacement for this API in PyMongo 3.1. It may make use of the existing son manipulators through a new API, or replace them completely.