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]]

The index sets themselves are already there.

Step 1: copying files from dune-istl to dune-common

[[Imported from SVN: r7110]]

[[Imported from SVN: r7079]]

exclude debugallocator.cc from doxygen documentation

[[Imported from SVN: r7019]]

add documentation for allocators

[[Imported from SVN: r7018]]

[[Imported from SVN: r6988]]

[[Imported from SVN: r6872]]

[[Imported from SVN: r6832]]

[[Imported from SVN: r6794]]

[[Imported from SVN: r6776]]

[[Imported from SVN: r6772]]

[[Imported from SVN: r6770]]