[Lldb-commits] [lldb] [lldb][docs] Try to fix forward the Sphinx automodapi doc generation (PR #208608)

[via lldb-commits]

llvmorg-github-actions[bot] wrote:


<!--LLVM PR SUMMARY COMMENT-->

@llvm/pr-subscribers-lldb

Author: Reid Kleckner (rnk)

<details>
<summary>Changes</summary>

Fixes LLDB doc generation errors for me locally

---
Full diff: https://github.com/llvm/llvm-project/pull/208608.diff


1 Files Affected:

- (modified) lldb/docs/python_extensions.md (+25-15) 


``````````diff
diff --git a/lldb/docs/python_extensions.md b/lldb/docs/python_extensions.md
index 4dca2c04f600b..ae3ca6245f6aa 100644
--- a/lldb/docs/python_extensions.md
+++ b/lldb/docs/python_extensions.md
@@ -8,43 +8,53 @@ This page describes some of these scripting extensions:
 ## Operating System Thread Plugins
 
 ```{eval-rst}
-.. automodapi:: lldb.plugins.operating_system
-    :no-heading:
+.. automodule:: lldb.plugins.operating_system
+
+.. automodsumm:: lldb.plugins.operating_system
+    :classes-only:
+    :toctree: python_api
     :skip: ScriptedThread
-    :no-inheritance-diagram:
 ```
 
 ## Scripted Frame Provider Plugins
 
 ```{eval-rst}
-.. automodapi:: lldb.plugins.scripted_frame_provider
-    :no-heading:
+.. automodule:: lldb.plugins.scripted_frame_provider
+
+.. automodsumm:: lldb.plugins.scripted_frame_provider
+    :classes-only:
+    :toctree: python_api
     :skip: ABCMeta
-    :no-inheritance-diagram:
 ```
 
 ## Scripted Process Plugins
 
 ```{eval-rst}
-.. automodapi:: lldb.plugins.scripted_process
-    :no-heading:
+.. automodule:: lldb.plugins.scripted_process
+
+.. automodsumm:: lldb.plugins.scripted_process
+    :classes-only:
+    :toctree: python_api
     :skip: ABCMeta
-    :no-inheritance-diagram:
 ```
 
 ## Scripted Platform Plugins
 
 ```{eval-rst}
-.. automodapi:: lldb.plugins.scripted_platform
-    :no-heading:
+.. automodule:: lldb.plugins.scripted_platform
+
+.. automodsumm:: lldb.plugins.scripted_platform
+    :classes-only:
+    :toctree: python_api
     :skip: ABCMeta
-    :no-inheritance-diagram:
 ```
 
 ## Scripted Thread Plan Plugins
 
 ```{eval-rst}
-.. automodapi:: lldb.plugins.scripted_thread_plan
-    :no-heading:
-    :no-inheritance-diagram:
+.. automodule:: lldb.plugins.scripted_thread_plan
+
+.. automodsumm:: lldb.plugins.scripted_thread_plan
+    :classes-only:
+    :toctree: python_api
 ```

``````````

</details>


https://github.com/llvm/llvm-project/pull/208608