matplotlib
diff --git a/‎doc/conf.py‎
Lines changed: 2 additions & 1 deletion b/‎doc/conf.py‎
Lines changed: 2 additions & 1 deletion
diff --git a/‎doc/sphinxext/rcparams.py‎
Lines changed: 39 additions & 0 deletions b/‎doc/sphinxext/rcparams.py‎
Lines changed: 39 additions & 0 deletions
@@ -132,8 +132,9 @@ def _parse_skip_subdirs_file():
     'sphinxext.math_symbol_table',
     'sphinxext.missing_references',
     'sphinxext.mock_gui_toolkits',
-    'sphinxext.skip_deprecated',
+    'sphinxext.rcparams',
     'sphinxext.redirect_from',
+    'sphinxext.skip_deprecated',
     'sphinx_copybutton',
     'sphinx_design',
     'sphinx_tags',
 
@@ -0,0 +1,39 @@
+from docutils.parsers.rst import Directive
+
+from matplotlib import rcsetup
+
+
+class RcParamsDirective(Directive):
+    has_content = False
+    required_arguments = 0
+    optional_arguments = 0
+    final_argument_whitespace = False
+    option_spec = {}
+
+    def run(self):
+        """
+        Generate rst documentation for rcParams.
+
+        Note: The style is very simple, but will be refined later.
+        """
+        self.state.document.settings.env.note_dependency(__file__)
+        self.state.document.settings.env.note_dependency(rcsetup.__file__)
+        lines = []
+        for param in rcsetup._params:
+            if param.name[0] == '_':
+                continue
+            lines += [
+                f'.. _rcparam_{param.name.replace(".", "_")}:',
+                '',
+                f'{param.name}: ``{param.default!r}``',
+                f'    {param.description if param.description else "*no description*"}'
+            ]
+        self.state_machine.insert_input(lines, 'rcParams table')
+        return []
+
+
+def setup(app):
+    app.add_directive("rcparams", RcParamsDirective)
+
+    metadata = {'parallel_read_safe': True, 'parallel_write_safe': True}
+    return metadata