From ac4031f5764303efe97831401f6d75a5e94d3721 Mon Sep 17 00:00:00 2001
From: Adam Dangoor <adamdangoor@gmail.com>
Date: Sat, 19 Sep 2026 10:35:25 +0100
Subject: [PATCH] Annotate publish_doctree parameters

---
 stubs/docutils/docutils/core.pyi | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/stubs/docutils/docutils/core.pyi b/stubs/docutils/docutils/core.pyi
index 1fca13033a3e..42722aeda762 100644
--- a/stubs/docutils/docutils/core.pyi
+++ b/stubs/docutils/docutils/core.pyi
@@ -1,8 +1,9 @@
 from _typeshed import Incomplete, StrPath
-from typing import Final
+from typing import IO, Final
 from typing_extensions import deprecated
 
 from docutils import SettingsSpec, nodes
+from docutils.frontend import Values
 from docutils.io import Input, Output
 from docutils.parsers import Parser
 from docutils.readers import Reader
@@ -144,16 +145,16 @@ def publish_parts(
     enable_exit_status: bool = False,
 ) -> _WriterParts: ...
 def publish_doctree(
-    source,
+    source: str | bytes | IO[str] | IO[bytes] | None,
     source_path: StrPath | None = None,
     source_class: type[Input[Incomplete]] = ...,
-    reader=None,
+    reader: Reader[Incomplete] | None = None,
     reader_name: str | None = None,
-    parser=None,
+    parser: Parser | None = None,
     parser_name: str | None = None,
-    settings=None,
-    settings_spec=None,
-    settings_overrides=None,
+    settings: Values | None = None,
+    settings_spec: SettingsSpec | type[SettingsSpec] | None = None,
+    settings_overrides: dict[str, Incomplete] | None = None,
     config_section: str | None = None,
     enable_exit_status: bool = False,
 ) -> nodes.document: ...