From 7b6769655f9b78e5fa32649ff33233e0f68550a2 Mon Sep 17 00:00:00 2001
From: Amir MOHAMMADI <amir.mohammadi@idiap.ch>
Date: Tue, 10 Nov 2020 11:39:37 +0100
Subject: [PATCH] Sphinx 3 autodoc no longer accepts autodoc_default_flags and
autodoc_default_options should be used
---
doc/conf.py | 31 +++++--------------------------
1 file changed, 5 insertions(+), 26 deletions(-)
diff --git a/doc/conf.py b/doc/conf.py
index 4c1a316d..a6c97e9a 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -233,11 +233,11 @@ rst_epilog = """
# Default processing flags for sphinx
autoclass_content = "class"
autodoc_member_order = "bysource"
-autodoc_default_flags = [
- "members",
- "undoc-members",
- "show-inheritance",
-]
+autodoc_default_options = {
+ "members": True,
+ "undoc-members": True,
+ "show-inheritance": True,
+}
sphinx_requirements = "extra-intersphinx.txt"
@@ -249,24 +249,3 @@ else:
intersphinx_mapping = link_documentation()
-# We want to remove all private (i.e. _. or __.__) members
-# that are not in the list of accepted functions
-accepted_private_functions = ["__array__"]
-
-
-def member_function_test(app, what, name, obj, skip, options):
- # test if we have a private function
- if len(name) > 1 and name[0] == "_":
- # test if this private function should be allowed
- if name not in accepted_private_functions:
- # omit privat functions that are not in the list of accepted private functions
- return skip
- else:
- # test if the method is documented
- if not hasattr(obj, "__doc__") or not obj.__doc__:
- return skip
- return False
-
-
-def setup(app):
- app.connect("autodoc-skip-member", member_function_test)
--
GitLab