NSDeprecatedをドキュメントジェネレータが特別に扱うのはともかくとして、正しい修正は各メソッドとプロパティにDeprecatedアノテーションをつけることだと思います。