Misc. Doxygen build system improvements
authorTeemu Murtola <teemu.murtola@gmail.com>
Sat, 13 Sep 2014 03:59:28 +0000 (06:59 +0300)
committerGerrit Code Review <gerrit@gerrit.gromacs.org>
Fri, 19 Sep 2014 03:06:02 +0000 (05:06 +0200)
commit301e6ab4c41152cfb791eaf6584abec08a96d652
tree924950a09e47c7554bd5e1cdca05d9b7cee70eae
parentf1234c6422f448e3091d2bcd33053df2e1ad769e
Misc. Doxygen build system improvements

- Only generate the installed header list once after CMake is run.
  It cannot change unless CMake is run again.  This wasn't particularly
  slow earlier either, but now it can be added as a dependency also in
  the -fast targets without any impact on the behavior.
- Do not update the Doxyfile-common each time CMake is run if
  GMX_COMPACT_DOXYGEN=ON.
- Partition the Markdown pages into subdirectories based on the
  documentation level where they should appear.  Exclude things from
  the documentation based on the directory, not individually.
- Use a CMake function to create the various Doxygen targets to remove
  some duplication.
- Some cleanup in the directories.cpp and misc.cpp documentation files.
- Some cleanup to use consistent casing throughout CMakeLists.txt.

Change-Id: I30de6f36841f25260700ec92284762e989f66507
16 files changed:
docs/doxygen/CMakeLists.txt
docs/doxygen/Doxyfile-common.cmakein
docs/doxygen/Doxyfile-user.cmakein
docs/doxygen/directories.cpp
docs/doxygen/lib/doxygen.md [moved from docs/doxygen/doxygen.md with 99% similarity]
docs/doxygen/lib/simd.md [moved from docs/doxygen/simd.md with 100% similarity]
docs/doxygen/lib/unittesting.md [moved from docs/doxygen/unittesting.md with 100% similarity]
docs/doxygen/lib/wrapperbinary.md [moved from docs/doxygen/wrapperbinary.md with 100% similarity]
docs/doxygen/misc.cpp
docs/doxygen/user/analysisdata.md [moved from docs/doxygen/analysisdata.md with 100% similarity]
docs/doxygen/user/analysisframework.md [moved from docs/doxygen/analysisframework.md with 100% similarity]
docs/doxygen/user/analysistemplate.md [moved from docs/doxygen/analysistemplate.md with 100% similarity]
docs/doxygen/user/codelayout.md [moved from docs/doxygen/codelayout.md with 100% similarity]
docs/doxygen/user/mainpage.md [moved from docs/doxygen/mainpage.md with 100% similarity]
docs/doxygen/user/selections.md [moved from docs/doxygen/selections.md with 100% similarity]
docs/doxygen/user/usinglibrary.md [moved from docs/doxygen/usinglibrary.md with 100% similarity]