Move some testutils and overview docs to dev guide
authorTeemu Murtola <teemu.murtola@gmail.com>
Mon, 4 May 2015 08:39:02 +0000 (11:39 +0300)
committerTeemu Murtola <teemu.murtola@gmail.com>
Sun, 10 May 2015 03:11:22 +0000 (05:11 +0200)
commitf7d5e4cb3be6505c5506ab0585a3a560737d7bea
tree8c97c43ccf866769b01f7068260c53b9346a5808
parent5d5989824b51611a3010eca8171791563767ada1
Move some testutils and overview docs to dev guide

The unittesting.md page for Doxygen got stranded after the parent commit
that converted the dev-manual folder to Sphinx.  Make this page part of
the developer guide.  Move those parts that had extensive references to
C++ classes to the testutils module documentation page in Doxygen and
extend them a bit.

Also, move the codelayout.md to the developer guide, as it fits better
there and there are several crosslinks between it and the developer
guide, while there are very few from the Doxygen documentation.

Add a mechanism to easily create crosslinks from Doxygen to the
developer guide.

Add some overview text for the developer guide to explain the structure
of the developer documentation.

Some further reorganization is necessary (in child commits) to get
better organization for the text; for now, just converted the
formatting, without changing the contents or organization significantly
within the pages.

Change-Id: I68706ffc961e1c23f5de0d62118095e90e05f4dd
17 files changed:
docs/CMakeLists.txt
docs/dev-manual/codelayout.rst [new file with mode: 0644]
docs/dev-manual/doxygen-links.rst
docs/dev-manual/doxygen.rst
docs/dev-manual/index.rst
docs/dev-manual/naming.rst
docs/dev-manual/overview.rst [new file with mode: 0644]
docs/dev-manual/testutils.rst [new file with mode: 0644]
docs/dev-manual/tools.rst
docs/doxygen/Doxyfile-common.cmakein
docs/doxygen/lib/unittesting.md [deleted file]
docs/doxygen/user/codelayout.md [deleted file]
docs/doxygen/user/mainpage.md
docs/doxygen/user/usinglibrary.md
docs/index.rst
src/testutils/testfilemanager.h
src/testutils/testutils-doc.h [new file with mode: 0644]