docs: Allow version_deprecated option

We also remove the unused 'version_changed' option.

Signed-off-by: Stephen Finucane <[email protected]>

Author: stephenfin

docs/tox_conf.py

@@ -24,7 +24,7 @@ class ToxConfig(SphinxDirective):
     option_spec: Final[ClassVar[dict[str, Any]]] = {
         "keys": unchanged_required,
         "version_added": unchanged,
-        "version_changed": unchanged,
+        "version_deprecated": unchanged,
         "default": unchanged,
         "constant": flag,
         "ref_suffix": unchanged,
@@ -71,6 +71,10 @@ def run(self) -> list[Node]:
             line += Text(" 📢 added in ")
             ver = self.options["version_added"]
             line += literal(ver, ver)
+        if "version_deprecated" in self.options:
+            line += Text(" ⚠️ deprecated in ")
+            ver = self.options["version_deprecated"]
+            line += literal(ver, ver)
 
         p = container("")
         self.state.nested_parse(StringList(string2lines("\n".join(f"    {i}" for i in self.content))), 0, p)