Doxygen fixes

[[Imported from SVN: r846]]

common/debugstream.hh

@@ -77,8 +77,8 @@ namespace Dune {
      Dune::DebugStream<APPL_GRAPHICS, APPL_DEBUG_MASK, APPL_ACTIVE_MASK, Dune::common_bits> graphout;
      \endcode
 
-     Applications that wish to redirect the standard streams from
-     stdstreams.hh through their private streams can use the tie()-mechanism:
+     Applications that wish to redirect the \ref StdStreams through their
+     private streams may use the tie()-mechanism:
 
      \code
      // initialize streams like above
@@ -92,6 +92,14 @@ namespace Dune {
 
      Keep in mind to untie() a stream before the tied stream is destructed.
 
+     An alternative is to attach() an output stream defined by the application:
+
+     \code
+     std::ofstream mylog("application.log");
+
+     Dune::dwarn.attach(mylog);
+     \endcode
+
    */
 
   //! type for debug levels. Only positive values allowed

common/stdstreams.hh

@@ -20,25 +20,20 @@ namespace Dune {
 
    */
 
-  /*! \addtogroup DebugOut
+  /*!
+     \addtogroup DebugOut
+     @{
 
-     \section Standard Streams
-
-     Laber Laber
-
-   */
-
-  /*! standard debug streams with level below MINIMAL_DEBUG_LEVEL will
+     standard debug streams with level below MINIMAL_DEBUG_LEVEL will
      collapse to doing nothing if output is requested.
 
-     For a Dune-Release this should be set to 5 so that only the grave
-     warnings and error messages are active. Otherwise, the
-     Dune-developers will adapt this setting to their debugging needs
-     locally
+     For a Dune-Release this should be set to at least 4 so that only
+     important messages are active. Dune-developers may adapt this
+     setting to their debugging needs locally
 
      Keep in mind that libdune has to be recompiled if this value is changed!
    */
-  static const DebugLevel MINIMAL_DEBUG_LEVEL = 3;
+  static const DebugLevel MINIMAL_DEBUG_LEVEL = 4;
 
   typedef DebugStream<1, MINIMAL_DEBUG_LEVEL> DVVerbType;
   extern DVVerbType dvverb;
@@ -57,4 +52,6 @@ namespace Dune {
 
   typedef DebugStream<1> DErrType;
   extern DErrType derr;
+
+  //! }@
 }