[deprecated.hh]

Update documentation for clang deprecation support. It reads still
clumsy and should be cleaned if we officially discontinue support for
older compilers.

[[Imported from SVN: r7004]]

dune/common/deprecated.hh

@@ -22,7 +22,7 @@
  * deprecated, users are advised to migrate to the new interface, since it
  * will probably be removed in the next release of Dune.
  *
- * DUNE_DEPRECATED currently works with g++ only.  For other compilers it will
+ * DUNE_DEPRECATED currently works with g++ and clang++.  For other compilers it will
  * be defined empty.  This way the user will not get any deprecation warning,
  * but at least his code still compiles (well, until the next Dune release,
  * that is).
@@ -36,7 +36,7 @@
  *    Both forms do not work properly with g++-4.1: no deprecation warning
  *    will be given, although the code still compiles.  1) should be preferred
  *    over 2) since 2) does not work with clang++-1.1 (again, no warning given
- *    but code still compiles)
+ *    but code still compiles, works with clang++-3.1)
  *  - Template classes
  *    \code
    template<class T>
@@ -44,7 +44,7 @@
    template<class T>
    class Class {} DUNE_DEPRECATED; // 2)
  *    \endcode
- *    This works works with g++-4.3, g++-4.4 and g++-4.5 only, g++-4.1 and
+ *    This works works with g++ >=4.3 only; g++-4.1 and
  *    clang++ compile the code without warning in both cases.  Furthermore,
  *    the warning is only triggered when copying an object of that template
  *    class, neither making a typedef nor simply creating such an object emit
@@ -57,8 +57,8 @@
    static const int DUNE_DEPRECATED c1 = 1;
    };
  *    \endcode
- *    Works with g++-4.1, g++-4.3, g++-4.4, g++-4.5.  No warning but clean
- *    compile with clang++-1.1.
+ *    Works with g++-4.1, g++ >=4.3 and clang++3.1.
+ *    No warning but clean compile with clang++-1.1.
  *  - Member enumerators
  *    \code
    template<typename T> struct Class {
@@ -141,8 +141,8 @@
    };
  *    \endcode
  *    Works without printing the hint on g++-4.1, g++-4.3, g++-4.4 and
- *    fully on g++ >= 4.5.  No warning but clean compile with
- *    clang++-1.1.
+ *    fully on g++ >= 4.5.  Works for clang++-3.1.
+ *    No warning but clean compile with clang++-1.1.
  *  - Member enumerators
  *    \code
    template<typename T> struct Class {