docs: Use directive:option in extensions/graphviz

1 files changed, 92 insertions, 15 deletions

diff --git a/doc/usage/extensions/graphviz.rst b/doc/usage/extensions/graphviz.rst
index 4d801d346..e5633c481 100644
--- a/doc/usage/extensions/graphviz.rst
+++ b/doc/usage/extensions/graphviz.rst
@@ -39,6 +39,45 @@ It adds these directives:
    .. versionchanged:: 1.1
       Added support for external files.
 
+   .. rubric:: options
+
+   .. rst:directive:option:: alt: alternate text
+      :type: text
+
+      The alternate text of the graph.  By default, the graph code is used to
+      the alternate text.
+
+      .. versionadded:: 1.0
+
+   .. rst:directive:option:: align: alignment of the graph
+      :type: left, center or right
+
+      The horizontal alignment of the graph.
+
+      .. versionadded:: 1.5
+
+   .. rst:directive:option:: caption: caption of the graph
+      :type: text
+
+      The caption of the graph.
+
+      .. versionadded:: 1.1
+
+   .. rst:directive:option:: graphviz_dot: dot command of the graph
+      :type: text
+
+      The graphviz command (ex. ``dot``, ``neato`` and so on) for rendering the
+      graph.  By default, :confval:`graphviz_dot` is used.
+
+      .. versionadded:: 1.4
+
+   .. rst:directive:option:: name: label
+      :type: text
+
+      The label of the graph.
+
+      .. versionadded:: 1.6
+
 
 .. rst:directive:: graph
 
@@ -56,6 +95,35 @@ It adds these directives:
       non-alphanumeric characters (e.g. a dash), you will have to double-quote
       it.
 
+   .. rubric:: options
+
+   Same as :rst:dir:`graphviz`.
+
+   .. rst:directive:option:: alt: alternate text
+      :type: text
+
+      .. versionadded:: 1.0
+
+   .. rst:directive:option:: align: alignment of the graph
+      :type: left, center or right
+
+      .. versionadded:: 1.5
+
+   .. rst:directive:option:: caption: caption of the graph
+      :type: text
+
+      .. versionadded:: 1.1
+
+   .. rst:directive:option:: graphviz_dot: dot command of the graph
+      :type: text
+
+      .. versionadded:: 1.4
+
+   .. rst:directive:option:: name: label
+      :type: text
+
+      .. versionadded:: 1.6
+
 
 .. rst:directive:: digraph
 
@@ -69,26 +137,35 @@ It adds these directives:
 
          "bar" -> "baz" -> "quux";
 
+   .. rubric:: options
+
+   Same as :rst:dir:`graphviz`.
+
+   .. rst:directive:option:: alt: alternate text
+      :type: text
+
+      .. versionadded:: 1.0
+
+   .. rst:directive:option:: align: alignment of the graph
+      :type: left, center or right
+
+      .. versionadded:: 1.5
+
+   .. rst:directive:option:: caption: caption of the graph
+      :type: text
+
+      .. versionadded:: 1.1
 
-.. versionadded:: 1.0
-   All three directives support an ``alt`` option that determines the image's
-   alternate text for HTML output.  If not given, the alternate text defaults to
-   the graphviz code.
+   .. rst:directive:option:: graphviz_dot: dot command of the graph
+      :type: text
 
-.. versionadded:: 1.1
-   All three directives support a ``caption`` option that can be used to give a
-   caption to the diagram.
+      .. versionadded:: 1.4
 
-.. versionchanged:: 1.4
-   All three directives support a ``graphviz_dot`` option that can be switch the
-   ``dot`` command within the directive.
+   .. rst:directive:option:: name: label
+      :type: text
 
-.. versionadded:: 1.5
-   All three directives support a ``align`` option to align the graph
-   horizontal.  The values "left", "center", "right" are allowed.
+      .. versionadded:: 1.6
 
-.. versionadded:: 1.6
-   All three directives support a ``name`` option to set the label to graph.
 
 There are also these config values: