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.

"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.

It has been obsolete since Doxygen 1.8.1

[[Imported from SVN: r7418]]

[[Imported from SVN: r7376]]

[[Imported from SVN: r7124]]

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

[[Imported from SVN: r6776]]

[[Imported from SVN: r6772]]

Add DUNE_DEPRECATED_MSG() to the predefined macros for Doxygen, otherwise it gets confused and messes up with \copydoc.

[[Imported from SVN: r6768]]

Add DUNE_DEPRECATED_MSG() to the predefined macros for Doxygen, otherwise it gets confused and messes up with \copydoc. 

[[Imported from SVN: r6767]]

Removed UseDoxygen.cmake as it does not seem to fit our needs.

BTW: Welcome to the CMake hell! It exists, I have experienced it!

[[Imported from SVN: r6624]]

[[Imported from SVN: r6623]]

Doyfile.in needs to be generated.

[[Imported from SVN: r6622]]

[[Imported from SVN: r6620]]

[[Imported from SVN: r6605]]

The documentation is still not built and therefore not installed

[[Imported from SVN: r6602]]

[[Imported from SVN: r6404]]

[[Imported from SVN: r6360]]

[[Imported from SVN: r6339]]

Please somebody verify that this is proper way.

[[Imported from SVN: r6014]]

[[Imported from SVN: r6013]]

[[Imported from SVN: r5977]]

[[Imported from SVN: r5923]]

[[Imported from SVN: r5922]]

[[Imported from SVN: r5815]]

[[Imported from SVN: r5812]]

[[Imported from SVN: r5804]]

[[Imported from SVN: r5794]]

[[Imported from SVN: r5782]]

[[Imported from SVN: r5775]]