From: Vladimír Vondruš <mosra@centrum.cz>
Date: Sat, 7 Nov 2020 15:59:11 +0000 (+0100)
Subject: doc: document what to do in Doxyfile for nice graphviz look.
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=b112ed2c2590cfb0edd4a26625f55cb53e7d7a4d;p=blog.git

doc: document what to do in Doxyfile for nice graphviz look.
---

diff --git a/doc/documentation/doxygen.rst b/doc/documentation/doxygen.rst
index 9c475937..19515e31 100644
--- a/doc/documentation/doxygen.rst
+++ b/doc/documentation/doxygen.rst
@@ -818,7 +818,17 @@ as well:
 
 Grapviz ``dot`` graphs from the ``@dot`` and ``@dotfile`` commands are rendered
 as an inline SVG. Graph name and the ``sizespec`` works equivalently to the
-`Images and figures`_.
+`Images and figures`_. In order to be consistent with the theme, set a matching
+font name and size in the `Doxyfile` --- these values match the default dark
+theme:
+
+.. code:: ini
+
+    DOT_FONTNAME = Source Sans Pro
+    DOT_FONTSIZE = 16.0
+
+See documentation of the `m.dot <{filename}/plugins/plots-and-graphs.rst#graphs>`_
+plugin for detailed information about behavior and supported features.
 
 `Pages, sections and table of contents`_
 ----------------------------------------