Also, you could use Sphinx's deprecation directive: http://sphinx-doc.org/markup/para.html#directive-deprecated