From 3b6894b62d6aae8f783c65810faa8ee949c99414 Mon Sep 17 00:00:00 2001
From: syphyr <syphyr@gmail.com>
Date: Sat, 25 Jul 2026 02:07:31 +0200
Subject: [PATCH] Add soft-deprecated to site-packages

Fixes #155095

make -C Doc changes

File "/home/cbot/.local/lib/python3.14/site-packages/sphinx/builders/changes.py", line 61, in write_documents
        ttext = self.typemap[changeset.type]
                ~~~~~~~~~~~~^^^^^^^^^^^^^^^^
    KeyError: 'soft-deprecated'
---
 Doc/conf.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Doc/conf.py b/Doc/conf.py
index 98e5531585d3f65..89d7fa4c85ab199 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -606,3 +606,14 @@
         '<meta property="og:image:width" content="200">',
         '<meta property="og:image:height" content="200">',
     )
+
+def setup(app):
+    try:
+        import sphinx.builders.changes
+        # We are reaching into the installed library and forcing the
+        # missing key into the class-level typemap.
+        if hasattr(sphinx.builders.changes, 'ChangesBuilder'):
+            if hasattr(sphinx.builders.changes.ChangesBuilder, 'typemap'):
+                sphinx.builders.changes.ChangesBuilder.typemap['soft-deprecated'] = 'soft-deprecated'
+    except ImportError:
+        pass