[all] documentation updates

dune/stuff/common/math.hh

@@ -197,7 +197,7 @@ protected:
   boost::accumulators::accumulator_set<ElementType, StatsType> acc_;
 };
 
-//! bound \param var in [\param min,\param max]
+//! \return var bounded in [min, max]
 template <typename T>
 T clamp(const T var, const T min, const T max)
 {

dune/stuff/common/profiler.hh

@@ -175,8 +175,7 @@ private:
     return pf;
   }
 
-  /** output to \param filename
-     * \tparam CollectiveCommunication should be Dune::CollectiveCommunication< MPI_Comm / double >
+  /** output to \param filename filename
      **/
   void outputCommon(const InfoContainer& run_infos, const boost::filesystem::path& filename,
                     const double scale_factor = 1.0) const;

dune/stuff/common/string.hh

@@ -51,7 +51,7 @@ inline std::string toString(const ReturnType& s)
   \brief      Returns a string of lengths s' whitespace (or c chars).
   \param[in]  s
               std::string, defines the length of the return string
-  \param[in]  c
+  \param[in]  whitespace
               char, optional argument, defines entries of return string
   \return     std::string
               Returns a string of lengths s' whitespace (or c chars).