From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Wed, 3 Aug 2022 20:43:14 +0000 (-0700)
Subject: gh-91207: Fix CSS bug in Windows CHM help file and add deprecation message (GH-95607)
X-Git-Tag: v3.11.0rc1~33
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=a591c4701ce707531775be8557a96376e7b57f8b;p=thirdparty%2FPython%2Fcpython.git

gh-91207: Fix CSS bug in Windows CHM help file and add deprecation message (GH-95607)

(cherry picked from commit ac3bf6155f8addc62f9a9c48f07eef8c3a6f71b2)

Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
---

diff --git a/Doc/conf.py b/Doc/conf.py
index 0c7deb59d130..2e670e5a8569 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -74,6 +74,13 @@ html_theme_options = {
     'root_include_title': False   # We use the version switcher instead.
 }
 
+# Override stylesheet fingerprinting for Windows CHM htmlhelp to fix GH-91207
+# https://github.com/python/cpython/issues/91207
+if any('htmlhelp' in arg for arg in sys.argv):
+    html_style = 'pydoctheme.css'
+    print("\nWARNING: Windows CHM Help is no longer supported.")
+    print("It may be removed in the future\n")
+
 # Short title used e.g. for <title> HTML tags.
 html_short_title = '%s Documentation' % release
 
diff --git a/Misc/NEWS.d/next/Documentation/2022-08-03-13-35-08.gh-issue-91207.eJ4pPf.rst b/Misc/NEWS.d/next/Documentation/2022-08-03-13-35-08.gh-issue-91207.eJ4pPf.rst
new file mode 100644
index 000000000000..8c7391f7edf7
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2022-08-03-13-35-08.gh-issue-91207.eJ4pPf.rst
@@ -0,0 +1,3 @@
+Fix stylesheet not working in Windows CHM htmlhelp docs
+and add warning that they are deprecated.
+Contributed by C.A.M. Gerlach.