From 2061b1161138b18dad333d028f24fded47776067 Mon Sep 17 00:00:00 2001
From: zoldalma <46655437+zoldalma999@users.noreply.github.com>
Date: Mon, 14 Jul 2025 21:50:45 +0200
Subject: [PATCH] Add stubs as dependencies to doc pages

---
 docs/reST/ext/documenters.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/reST/ext/documenters.py b/docs/reST/ext/documenters.py
index 9ecec61f38..3c9438edae 100644
--- a/docs/reST/ext/documenters.py
+++ b/docs/reST/ext/documenters.py
@@ -74,6 +74,18 @@ def get_doc(env, obj):
 
 
 class AutopgDocumenter(autoapi.documenters.AutoapiDocumenter):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        stub_path = self.env.srcdir.parent.parent / "buildconfig" / "stubs" / "pygame"
+        stub_file = stub_path / f"{self.env.docname.removeprefix('ref/')}.pyi"
+        if stub_file.exists():
+            self.env.note_dependency(stub_file.as_posix())
+
+        src_path = self.env.srcdir.parent.parent / "src_py"
+        src_file = src_path / f"{self.env.docname.removeprefix('ref/')}.py"
+        if src_file.exists():
+            self.env.note_dependency(src_file.as_posix())
+
     def format_signature(self, **kwargs):
         return ""