BF: remove deprecate with doc ; breaks doc build

deprecate_with_doc decorator deceived sphinx - maybe because the class
appears as a function.