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.

This fixes make dist.

Configration of dune fails if the manpages are not distributed.

Professional software has man pages.

It has been obsolete since Doxygen 1.8.1

[[Imported from SVN: r7418]]

[[Imported from SVN: r7413]]

Skip LATEX_USABLE guard for communication.pdf as the check is incorporated into dune_add_latex_document.

[[Imported from SVN: r7405]]

Skip LATEX_USABLE guard for buildsystem.pdf as the check is incorporated into dune_add_latex_document.

[[Imported from SVN: r7404]]

[[Imported from SVN: r7393]]

The tarballs already contain the generated pdf files. No CMake 
will detect whether the pdf are contained in the source tree.
If that is the case they will not be generated and installed directly.

[[Imported from SVN: r7380]]

[[Imported from SVN: r7376]]

[[Imported from SVN: r7366]]

Revision 6654
.-----------------
Merge sync to keep track with the trunk.

Thanks for renaming files and targets. Always a pleasure to mimic this manually.


[[Imported from SVN: r7365]]

[[Imported from SVN: r7126]]

[[Imported from SVN: r7124]]

[[Imported from SVN: r7122]]

[[Imported from SVN: r7116]]