aboutsummaryrefslogtreecommitdiffstats
path: root/doc/_templates
diff options
context:
space:
mode:
authorPatrick Lehmann <Patrick.Lehmann@plc2.de>2021-01-04 16:07:11 +0100
committertgingold <tgingold@users.noreply.github.com>2021-01-05 18:50:44 +0100
commit29755634957933656e0e318a64bd5806b52cbf1c (patch)
tree24afab0330dcac51e1694f55f6facbf0f6607274 /doc/_templates
parentd3ea0331006011861f539cbbaa60c8760b0fc620 (diff)
downloadghdl-29755634957933656e0e318a64bd5806b52cbf1c.tar.gz
ghdl-29755634957933656e0e318a64bd5806b52cbf1c.tar.bz2
ghdl-29755634957933656e0e318a64bd5806b52cbf1c.zip
Enabled missing Sphinx extensions. Fixed role name cls to class.
Diffstat (limited to 'doc/_templates')
-rw-r--r--doc/_templates/autoapi/module.rst143
1 files changed, 143 insertions, 0 deletions
diff --git a/doc/_templates/autoapi/module.rst b/doc/_templates/autoapi/module.rst
new file mode 100644
index 000000000..e359b32af
--- /dev/null
+++ b/doc/_templates/autoapi/module.rst
@@ -0,0 +1,143 @@
+{{ node.name }}
+=={{ '=' * node.name|length }}==
+
+.. automodule:: {{ node.name }}
+
+{##}
+{%- block modules -%}
+{%- if subnodes %}
+
+.. #-----------------------------------
+{##}
+**Submodules**
+
+.. toctree::
+{% for item in subnodes %}
+ {{ item.name }}
+{%- endfor %}
+{##}
+{%- endif -%}
+{%- endblock -%}
+{##}
+.. currentmodule:: {{ node.name }}
+{##}
+
+.. #-----------------------------------
+{##}
+{%- if node.variables %}
+**Variables**
+{##}
+{% for item, obj in node.variables.items() -%}
+- :py:data:`{{ item }}`
+{% endfor -%}
+{%- endif -%}
+
+
+{%- if node.exceptions %}
+{##}
+**Exceptions**
+{##}
+{% for item, obj in node.exceptions.items() -%}
+- :py:exc:`{{ item }}`:
+ {{ obj|summary }}
+
+{% endfor -%}
+{%- endif -%}
+
+
+{%- if node.classes %}
+{##}
+**Classes**
+{##}
+{% for item, obj in node.classes.items() -%}
+- :py:class:`{{ item }}`:
+ {{ obj|summary }}
+
+{% endfor -%}
+{%- endif -%}
+
+
+{%- if node.functions %}
+{##}
+**Functions**
+{##}
+{% for item, obj in node.functions.items() -%}
+- :py:func:`{{ item }}`:
+ {{ obj|summary }}
+
+{% endfor -%}
+{%- endif -%}
+
+
+{%- block variables -%}
+{%- if node.variables %}
+{% for item, obj in node.variables.items() %}
+.. autodata:: {{ item }}
+ :annotation:
+
+ .. code-block:: guess
+
+ {{ obj|pprint|indent(6) }}
+{##}
+{%- endfor -%}
+{%- endif -%}
+{%- endblock -%}
+
+
+{%- block exceptions -%}
+{%- if node.exceptions %}
+
+.. #-----------------------------------
+
+{% for item in node.exceptions %}
+.. autoexception:: {{ item }}
+ :members:
+ :private-members:
+ :inherited-members:
+ :undoc-members:
+{##}
+ .. rubric:: Inheritance
+ .. inheritance-diagram:: {{ item }}
+{##}
+ .. rubric:: Members
+{##}
+{%- endfor -%}
+{%- endif -%}
+{%- endblock -%}
+
+
+{%- block classes -%}
+{%- if node.classes %}
+
+.. #-----------------------------------
+
+{% for item in node.classes %}
+.. autoclass:: {{ item }}
+ :members:
+ :private-members:
+ :undoc-members:
+ :inherited-members:
+{##}
+ .. rubric:: Inheritance
+ .. inheritance-diagram:: {{ item }}
+{##}
+ .. rubric:: Members
+{##}
+{%- endfor -%}
+{%- endif -%}
+{%- endblock -%}
+
+
+{%- block functions -%}
+{%- if node.functions %}
+
+.. #-----------------------------------
+
+**Functions**
+
+{% for item in node.functions %}
+.. autofunction:: {{ item }}
+{##}
+{%- endfor -%}
+{%- endif -%}
+{%- endblock -%}