This is intended to contain everything related to type
computations, like, e.g., type traits, helpers for
overload resolution, ...

This way, the docs get much more readable.

It is outdated.

We aim to document the entire relevant user API. Some functions
from CMake are not worth wrapping, so we need to add them to our
documentation.

We do not want one such documentation per module, but instead
we would allow people to use it from their module and get a
documentation generated from all the dependent modules. This
needs some changes to the machine.

This includes the following workflow:

* The cmake module path is globbed for any modules matching *.cmake
* The opening comment is parsed for the following rst directives:
  cmake_function, cmake_module, cmake_variables
* From those, a browsable documentation is generated.

To run properly, a python interpreter and sphinx are needed.

Add missing files, remove ancient buildsystem stuff and stuff where it is
unclear where it comes from.

- add question concerning configure options
- add question concerning disabling options
- mention deletion of CMakeCache.txt

Update CXXFLAG question.
More proof reading and line wrapping.

- Get rid of \\ at end of paragraphs
- Fix various misspellings
- add some convenience macros
- add myself as co-author
- break long lines which were modified anyway

This document gathers some beginners question about the CMake
build system. It is built during make doc and made available
on the website through the doc installation.

Those create a lot of output (basically what method uses what other method
and what method is used by what other method), which I doubt a whole lot
of people find useful.  Turning them off makes the html output much more
pleasant to read.

Fixes FS#FS#1649.

mention cmake and CMAKE_FLAGS. Add an example for CMAKE_FLAGS in the
example opts file. Also update the compiler version in the example opts
file to a version that is actually supported by dune.

"Makefile.in", "*.o", etc. need only be listed in the toplevel .gitignore, the
rules are applied recursively.

Test programs etc. should be listed as "/program" in their directory's
.gitignore, so they are not accidentially ignored in a lower level directory.

The clutter the output.  I can't believe anyone really wants to see
the friend relationships in doxygen.

With openSuse 12.3 (Doxygen 1.8.5) the generated documentation contains
lots of huge graphs which show the include dependency graph of a file.
This lead to large tarballs of 155 MiB compared to 50 MiB with this
patch.
With Debian Wheezy (Doxygen 1.8.1.2) the tarballs did not blow up in
file size. Scanning the Doxygen change log did not enlighten me and
I remain puzzled why the graph were never built.

INCLUDED_BY_GRAPH is changed to prevent the same behvior for future
releases. We currently do not include these graphs and this change
makes the configureation consistent with the result.

docdir is variable of automake and its by default set to $(datadir)/doc/dune-common.
Therefore there is not need to set it here.

When moving the documentation of the parallel index sets from dune-istl
to dune-common, we forgot to adjust the installation directories accordingly.
This patch fixes this situation.