From 6c7af3fdd68a9ebda27a206c6db977bc43b2ac02 Mon Sep 17 00:00:00 2001
From: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Date: Tue, 22 Oct 2024 14:07:09 +0100
Subject: [PATCH] Doc: Show object descriptions in the table of contents
 (GH-125757) (cherry picked from commit
 91ddde4af0c3031c84a967bcf59f6fb4f8a48c0d)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
---
 Doc/conf.py                        | 3 ++-
 Doc/tools/extensions/pyspecific.py | 1 +
 Doc/tools/static/sidebar-wrap.css  | 6 ++++++
 3 files changed, 9 insertions(+), 1 deletion(-)
 create mode 100644 Doc/tools/static/sidebar-wrap.css

diff --git a/Doc/conf.py b/Doc/conf.py
index db8fb9a9a68c6b..7ee3c91581345d 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -94,7 +94,8 @@
 
 # Create table of contents entries for domain objects (e.g. functions, classes,
 # attributes, etc.). Default is True.
-toc_object_entries = False
+toc_object_entries = True
+toc_object_entries_show_parents = 'hide'
 
 # Ignore any .rst files in the includes/ directory;
 # they're embedded in pages but not rendered individually.
diff --git a/Doc/tools/extensions/pyspecific.py b/Doc/tools/extensions/pyspecific.py
index ec46c148a585d1..b33add00b9ce71 100644
--- a/Doc/tools/extensions/pyspecific.py
+++ b/Doc/tools/extensions/pyspecific.py
@@ -411,5 +411,6 @@ def setup(app):
     app.add_directive_to_domain('py', 'awaitablemethod', PyAwaitableMethod)
     app.add_directive_to_domain('py', 'abstractmethod', PyAbstractMethod)
     app.add_directive('miscnews', MiscNews)
+    app.add_css_file('sidebar-wrap.css')
     app.connect('env-check-consistency', patch_pairindextypes)
     return {'version': '1.0', 'parallel_read_safe': True}
diff --git a/Doc/tools/static/sidebar-wrap.css b/Doc/tools/static/sidebar-wrap.css
new file mode 100644
index 00000000000000..0a80f516f28349
--- /dev/null
+++ b/Doc/tools/static/sidebar-wrap.css
@@ -0,0 +1,6 @@
+div.sphinxsidebarwrapper {
+    overflow-x: scroll;
+}
+div.sphinxsidebarwrapper li code {
+    overflow-wrap: normal;
+}