From cb911ab2260375bd7908aee42719e747345018e2 Mon Sep 17 00:00:00 2001
From: Serhiy Storchaka <storchaka@gmail.com>
Date: Fri, 4 Sep 2026 19:14:06 +0300
Subject: [PATCH] gh-59551: Add a stub page for the old library/dialog.html URL

Add support for the "*" marker in Doc/tools/removed-ids.txt, which
excludes all IDs of a page from the check-html-ids.py check.
---
 Doc/library/dialog.rst      | 15 +++++++++++++++
 Doc/tools/check-html-ids.py |  2 ++
 Doc/tools/removed-ids.txt   |  4 +++-
 3 files changed, 20 insertions(+), 1 deletion(-)
 create mode 100644 Doc/library/dialog.rst

diff --git a/Doc/library/dialog.rst b/Doc/library/dialog.rst
new file mode 100644
index 00000000000000..c101cf0a7c0840
--- /dev/null
+++ b/Doc/library/dialog.rst
@@ -0,0 +1,15 @@
+:orphan:
+
+.. This page is retained solely for existing links to library/dialog.html.
+   Direct readers to the renamed page instead.
+
+Tkinter dialogs
+===============
+
+This page has been renamed.  The modules it documented are now described in
+:doc:`./tkinter.dialogs`:
+
+* :mod:`tkinter.simpledialog`
+* :mod:`tkinter.filedialog`
+* :mod:`tkinter.commondialog`
+* :mod:`tkinter.dialog`
diff --git a/Doc/tools/check-html-ids.py b/Doc/tools/check-html-ids.py
index 3ea0a99d1dd4f6..7c0209067ae4ac 100644
--- a/Doc/tools/check-html-ids.py
+++ b/Doc/tools/check-html-ids.py
@@ -83,6 +83,8 @@ def do_check(baseline, checked, excluded, *, verbose_print):
                 print(f'{name}: (page missing)')
                 print()
         else:
+            if (name, '*') in excluded:
+                continue
             missing_ids = set(baseline_ids) - set(checked_ids)
             if missing_ids:
                 missing_ids = {
diff --git a/Doc/tools/removed-ids.txt b/Doc/tools/removed-ids.txt
index ae116da1456641..cda7bba526e7d1 100644
--- a/Doc/tools/removed-ids.txt
+++ b/Doc/tools/removed-ids.txt
@@ -1,4 +1,6 @@
 # HTML IDs excluded from the check-html-ids.py check.
+# Use "*" instead of an ID to exclude all IDs of a page, and
+# "(page missing)" to allow the page itself to be removed.
 
 # Remove from here in 3.16
 c-api/allocation.html: deprecated-aliases
@@ -84,4 +86,4 @@ reference/expressions.html: generator.send
 reference/expressions.html: generator.throw
 
 # Renamed to library/tkinter.dialogs.html
-library/dialog.html: (page missing)
+library/dialog.html: *