Feature/fs1702 cmake add suitesparse support rebased

I had to fix Sphinx and tested it with the LDL branch from dune-istl.
Tested by Tobias and Marco, thanks!

See merge request !8

Thanks Dominic for the hint!

Otherwise the test could mark SuiteSparse as not found which
would break the search for other SuiteSparse libraries.

* Fix capitalization of SUITESPARSE_INCLUDE_DIRS
* Drop PATHS when searching SuiteSparse_config.h in default paths
* Add variable dereferencing in string(TOLOWER
* Set SuiteSparse_${_component}_FOUND only TRUE if actually found
* Mark more variables as advanced

According to the naming convention the variables which are
used outside must have the same capitalization as the Find*
module.
Previsously we used SUITESPARSE_*.

FindPackageHandleStandardArgs provides everthing we need.

If BLAS is not found, the whole configure process is
aborted. We actually want that BLAS is a requirement
for SuiteSparse. It is better to check using
FindPackageHandleStandardArgs.

The naming scheme is kind of broken.

Adjust code to reflect comment.

Tobias Malkmus authored 9 years ago and Christoph Grüninger committed 9 years ago

This patch adds the cmake findpackage script which locates Tim Davis' SuiteSparsae collection.

If a certain setting of the SuiteSparse library should be used it can be found using
find_package( SuiteSparse COMPONENETS <list-of-components> )
with a specific list of components.
Existence of components can be check using the SUITESPARSE_<comp>_FOUND/HAVE_SUITESPARSE_<comp> cmake variable.

The UMFPack search routines are redirected to the more general FindSuiteSparse script.

We may drop the 'links' section in favour of just linking those pages
in the text.

Deprecate dune/common/alignment.hh

alignment.hh provides Dune::AlignmentOf<T>::value which is identical to std::alignment_of<T>::value.
This merge request replaces use of AlignmentOf with the shorter alignof() operator introduced in C++11 and deprecates the header.

See merge request !6

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

GitLab readable contribution guide, license and README

Adding the `.md` extension enables rendering of the files, which is much nicer.

Also ported the contribution guide from the User Wiki.

Renamed COPYING to LICENSE.md because that is the name that GitLab looks for to display it nicely on the project starting page.

If this one is accepted, I will do the same for the other core modules.

See merge request !5

The alignof() operator was introduced in C++11.

Conans ancient compiler has problems since the latest
changes to the Dune Exceptions. We switch the dune-common
check to a more easy header...

Implement some new features for dune_add_test

* `COMMANDS` was requested by @tkoch on the mailing list
* `COMPILE_ONLY` is useful for my latest YaspGrid tests, that check the code with and without deprecated interface features.
* `TIMEOUT` sets the timeout for ctest and is need in parallel testing

See merge request !1

This reverts commit 8bd9ff56.

The commit did not apply the correct fix, as MPI_RANKS is not a number
but a list of ranks instead. Also, I doubt the existence of ">".

ADDTEST_MPI_RANKS is set two lines above if it has been emtpy.

This allows to give priorities to otherwise ambiguous
overloads. It's main use is to make multiple overloads
work, when only some are ruled out via SFINAE. This is
e.g. used in the concepts check that I'll move to
dune-common soon.

The implemention is trivial but makes such applications
more readable and idiomatic compared to other approaches
where, e.g., null pointers are passed to overloads
have T* and void* dummy arguments.

Due to it's simplicity a separate header may not be justified,
but none of the existing seems to fit.

It needs to be specified when using MPI_RANKS. IT otherwise
defaults to 5 minutes. No test should ever run that long, I
guess, but the default keeps automated systems from entirely
hanging up.