DuneDoxygen
===========

Support for building module documentation with Doxygen.

.. cmake:command:: add_doxygen_target

  Create a Doxygen build target for the current module.

  .. code-block:: cmake

    add_doxygen_target(
      [TARGET <target-suffix>]
      [DEPENDS <files>...]
      [OUTPUT <path>]
    )

  ``TARGET``
    Suffix of the generated build target. The default is the current module
    name.

  ``DEPENDS``
    Additional dependencies of the generated Doxygen build step, for example a
    manually maintained ``mainpage.txt`` file.

  ``OUTPUT``
    Output path produced by the Doxygen run. The default is the generated
    ``html`` directory in the current binary directory.

  This command creates a module-specific ``doxygen_<target>`` target and adds
  it as a dependency of the top-level ``doxygen`` and ``doc`` targets. During
  installation, the generated Doxygen output is copied into
  ``${CMAKE_INSTALL_DOCDIR}/doxygen``.

.. cmake:variable:: DUNE_MATHJAX_DISABLE_LOCAL

  If set to ``TRUE``, local MathJax discovery is disabled and Doxygen will not
  use an installed MathJax2 copy from the system.

.. cmake:variable:: DUNE_MATHJAX_DISABLE_CDN

  If set to ``TRUE``, MathJax will not be loaded from the content delivery
  network when no local MathJax2 installation is available.