diff --git a/dune/common/documentation.hh b/dune/common/documentation.hh
index dad773f616e88c66a41ca91f0b2c00e873c9b0a4..e783a9c44ec0283a4d6c6838be075ebc9c9dc9f9 100644
--- a/dune/common/documentation.hh
+++ b/dune/common/documentation.hh
@@ -10,38 +10,40 @@
 
 namespace Dune {
 
-  //! Dummy struct used for documentation purposes
   /**
+   * \brief Dummy struct used for documentation purposes
+   *
    * This struct can be used for documenting interfaces.  One example would
    * be:
    * \code
-     // Traits class that determines some property for some other type T
-     template<class T>
-     class SomeTraits {
-     dune_static_assert(AlwaysFalse<T>::value,
-                     "Sorry, SomeTraits must be specialized for all types");
-     public:
-     // The type of some property of T
-     typedef ImplementationDefined type;
-     };
-   *#ifndef DOXYGEN
-     template<>
-     struct SomeTraits<int>
-     typedef ... type;
-     };
-     // ...
-   *#endif // DOXYGEN
+   * // Traits class that determines some property for some other type T
+   * template<class T>
+   * class SomeTraits {
+   *   dune_static_assert(AlwaysFalse<T>::value,
+   *                      "Sorry, SomeTraits must be specialized for all types");
+   * public:
+   *   // The type of some property of T
+   *   typedef ImplementationDefined type;
+   * };
+   * #ifndef DOXYGEN
+   * template<>
+   * struct SomeTraits<int>
+   *   typedef ... type;
+   * };
+   * // ...
+   * #endif // DOXYGEN
    * \endcode
    *
    * \sa implementationDefined
    */
   struct ImplementationDefined {};
 
-  //! Dummy integral value used for documentation purposes
   /**
+   * \brief Dummy integral value used for documentation purposes
+   *
    * \var Dune::implementationDefined
    * \code
-   *#include <dune/common/documentation.hh>
+   * #include <dune/common/documentation.hh>
    * \endcode
    *
    * \sa ImplementationDefined