[doxygen] Fix more typos, blank spaces, etc. in tests folders

test/freeflow/navierstokes/angeli/main.cc

@@ -107,7 +107,7 @@ int main(int argc, char** argv) try
     auto gridVariables = std::make_shared<GridVariables>(problem, fvGridGeometry);
     gridVariables->init(x);
 
-    // intialize the vtk output module
+    // initialize the vtk output module
     StaggeredVtkOutputModule<GridVariables, SolutionVector> vtkWriter(*gridVariables, x, problem->name());
     using IOFields = GetPropType<TypeTag, Properties::IOFields>;
     IOFields::initOutputModule(vtkWriter); //!< Add model specific output fields

test/freeflow/navierstokes/donea/problem.hh

@@ -19,7 +19,7 @@
 /*!
  * \file
  * \ingroup NavierStokesTests
- * \brief Test for the staggered grid (Navier-)Stokes model with analytical solution (Donea et al., 2003)
+ * \brief Test for the staggered grid (Navier-)Stokes model with analytical solution (Donea 2003, \cite Donea2003).
  */
 #ifndef DUMUX_DONEA_TEST_PROBLEM_HH
 #define DUMUX_DONEA_TEST_PROBLEM_HH
@@ -79,8 +79,11 @@ struct EnableGridFaceVariablesCache<TypeTag, TTag::DoneaTest> { static constexpr
 
 /*!
  * \ingroup NavierStokesTests
- * \brief  Test problem for the staggered grid (Donea et al., 2003)
- * \todo doc me!
+ * \brief  Test problem for the staggered grid (Donea 2003, \cite Donea2003).
+ *
+ * A two-dimensional Stokes flow in a square domain is considered.
+ * With the source terms as given in Donea 2003 \cite Donea2003, an analytical solution
+ * is available and can be compared to the numerical solution.
  */
 template <class TypeTag>
 class DoneaTestProblem : public NavierStokesProblem<TypeTag>
@@ -244,7 +247,7 @@ public:
     // \{
 
    /*!
-     * \brief Evaluate the initial value for a control volume.
+     * \brief Evaluates the initial value for a control volume.
      *
      * \param globalPos The global position
      */
@@ -327,6 +330,6 @@ private:
     std::vector<VelocityVector> analyticalVelocity_;
     std::vector<VelocityVector> analyticalVelocityOnFace_;
 };
-} //end namespace
+} // end namespace Dumux
 
 #endif

test/freeflow/navierstokes/kovasznay/problem.hh

@@ -19,7 +19,7 @@
 /*!
  * \file
  * \ingroup NavierStokesTests
- * \brief Test for the staggered grid Navier-Stokes model with analytical solution (Kovasznay 1947).
+ * \brief Test for the staggered grid Navier-Stokes model with analytical solution (Kovasznay 1948, \cite Kovasznay1948)
  */
 
 #ifndef DUMUX_KOVASZNAY_TEST_PROBLEM_HH
@@ -72,8 +72,11 @@ struct EnableGridVolumeVariablesCache<TypeTag, TTag::KovasznayTest> { static con
 
 /*!
  * \ingroup NavierStokesTests
- * \brief  Test problem for the staggered grid (Kovasznay 1947)
- * \todo doc me!
+ * \brief  Test problem for the staggered grid (Kovasznay 1948, \cite Kovasznay1948)
+ *
+ * A two-dimensional Navier-Stokes flow with a periodicity in one direction
+ * is considered. The set-up represents a wake behind a two-dimensional grid
+ * and is chosen in a way such that an exact solution is available.
  */
 template <class TypeTag>
 class KovasznayTestProblem : public NavierStokesProblem<TypeTag>

test/freeflow/navierstokesnc/channel/problem.hh

@@ -97,8 +97,12 @@ struct UseMoles<TypeTag, TTag::ChannelNCTest> { static constexpr bool value = tr
 
 /*!
  * \ingroup NavierStokesNCTests
- * \brief  Test problem for the one-phase model.
- * \todo doc me!
+ * \brief  Test problem for the one-phase (Navier-)Stokes model.
+ *
+ * Flow from left to right in a channel is considered. A parabolic velocity
+ * profile is set at the left boundary, while the pressure is set to
+ * a fixed value on the right boundary. The top and bottom boundaries
+ * represent solid walls with no-slip/no-flow conditions.
  */
 template <class TypeTag>
 class ChannelNCTestProblem : public NavierStokesProblem<TypeTag>

test/freeflow/navierstokesnc/densitydrivenflow/problem.hh

@@ -87,7 +87,7 @@ struct UseMoles<TypeTag, TTag::DensityDrivenFlow> { static constexpr bool value
  * Here, a quadratic two-dimensional domain with closed and non-moving walls at
  * all sides is considered. Initially, the domain is filled with pure water.
  * At the top, a fixed concentration of the air component is set.
- * The air slowly dissolves in the water which leads to an local increase of density.
+ * The air slowly dissolves in the water which leads to a local increase of density.
  * Due to the influence of gravity and
  * small numerical instabilities, fingers of denser water will form and sink downwards.
  */

test/freeflow/navierstokesnc/maxwellstefan/problem.hh

@@ -196,7 +196,7 @@ public:
 template<class TypeTag>
 struct FluidSystem<TypeTag, TTag::MaxwellStefanNCTest> { using type = MaxwellStefanFluidSystem<TypeTag>; };
 
-} //end namespace Properties
+} // end namespace Properties
 
 /*!
  * \ingroup NavierStokesNCTests

test/multidomain/boundary/darcydarcy/1p_2p/problem.hh

@@ -33,7 +33,11 @@ namespace Dumux {
 /*!
  * \ingroup OnePTests
  * \brief  Multidomain test problem for the incompressible one-phase model
- * \todo doc me!
+ *
+ * The circular model domain consists of two subdomains:
+ * an inner circle and an outer ring.
+ * Methane is injected in the center and spreads over the
+ * coupling boundary into the outer domain.
  */
 template<class TypeTag, std::size_t tag>
 class OnePTestProblem

test/multidomain/boundary/stokesdarcy/1p2c_2p2c/problem_darcy.hh

@@ -283,8 +283,8 @@ public:
      */
     // \{
     /*!
-     * \brief Evaluate the source term for all phases within a given
-     *        sub-control-volume.
+     * \brief Evaluates the source term for all phases within a given
+     *        sub control volume.
      *
      * \param element The element for which the source term is set
      * \param fvGeometry The fvGeometry

test/multidomain/boundary/stokesdarcy/1p_2p/problem_darcy.hh

@@ -200,8 +200,7 @@ public:
     }
 
     /*!
-     * \brief Evaluate the boundary conditions for a Neumann
-     *        control volume.
+     * \brief Evaluates the boundary conditions for a Neumann control volume.
      *
      * \param element The element for which the Neumann boundary condition is set
      * \param fvGeometry The fvGeometry

test/multidomain/facet/1p_1p/analytical/problem_lowdim.hh

@@ -162,7 +162,7 @@ public:
     Scalar extrusionFactorAtPos(const GlobalPosition& globalPos) const
     { return aperture_; }
 
-    //! evaluate the initial conditions
+    //! Evaluates the initial conditions.
     PrimaryVariables initialAtPos(const GlobalPosition& globalPos) const
     { return PrimaryVariables(1.0); }
 

test/multidomain/facet/1p_1p/gravity/problem_bulk.hh

@@ -149,7 +149,7 @@ public:
                         const SubControlVolumeFace& scvf) const
     { return NumEqVector(0.0); }
 
-    //! evaluate the initial conditions
+    //! Evaluates the initial conditions.
     PrimaryVariables initialAtPos(const GlobalPosition& globalPos) const
     {
         const auto g = this->gravityAtPos(globalPos)[dimWorld-1];

test/multidomain/facet/tracer_tracer/problem_1p_lowdim.hh

@@ -149,7 +149,7 @@ public:
     Scalar extrusionFactorAtPos(const GlobalPosition& globalPos) const
     { return aperture_; }
 
-    //! evaluate the initial conditions
+    //! Evaluates the initial conditions.
     PrimaryVariables initialAtPos(const GlobalPosition& globalPos) const
     { return PrimaryVariables(1.0e5); }
 

test/porousmediumflow/1p/implicit/compressible/instationary/spatialparams.hh

@@ -66,7 +66,7 @@ public:
      * \brief Function for defining the (intrinsic) permeability \f$[m^2]\f$.
      *
      * \param element The element
-     * \param scv The sub control volume
+     * \param scv The sub-control volume
      * \param elemSol The element solution vector
      * \return The intrinsic permeability
      */

test/porousmediumflow/1p/implicit/compressible/stationary/spatialparams.hh

@@ -66,7 +66,7 @@ public:
      * \brief Function for defining the (intrinsic) permeability \f$[m^2]\f$.
      *
      * \param element The element
-     * \param scv The sub control volume
+     * \param scv The sub-control volume
      * \param elemSol The element solution vector
      * \return The intrinsic permeability
      */

test/porousmediumflow/1p/implicit/fracture2d3d/problem.hh

@@ -229,6 +229,6 @@ private:
     std::string name_;
 };
 
-} //end namespace Dumux
+} // end namespace Dumux
 
 #endif

test/porousmediumflow/1p/implicit/incompressible/spatialparams.hh

@@ -68,7 +68,7 @@ public:
      * \brief Function for defining the (intrinsic) permeability \f$[m^2]\f$.
      *
      * \param element The element
-     * \param scv The sub control volume
+     * \param scv The sub-control volume
      * \param elemSol The element solution vector
      * \return The intrinsic permeability
      */

test/porousmediumflow/1p/implicit/isothermal/problem.hh

@@ -233,6 +233,6 @@ private:
     static constexpr Scalar eps_ = 1.0e-6;
 };
 
-} //end namespace Dumux
+} // end namespace Dumux
 
 #endif

test/porousmediumflow/1p/implicit/isothermal/spatialparams.hh

@@ -81,7 +81,7 @@ public:
      * \brief Function for defining the (intrinsic) permeability \f$[m^2]\f$.
      *
      * \param element The element
-     * \param scv The sub control volume
+     * \param scv The sub-control volume
      * \param elemSol The element solution vector
      * \return The intrinsic permeability
      */

test/porousmediumflow/1p/implicit/network1d3d/problem.hh

@@ -246,7 +246,7 @@ public:
 
     /*!
      * \brief Evaluates the source term for all phases within a given
-     *        sub-control-volume.
+     *        sub-control volume.
      *
      * This is the method for the case where the source term is
      * potentially solution dependent and requires some quantities that
@@ -255,10 +255,10 @@ public:
      * \param element The finite element
      * \param fvGeometry The finite-volume geometry
      * \param elemVolVars All volume variables for the element
-     * \param scv The sub control volume
+     * \param scv The sub-control volume
      *
      * For this method, the \a values parameter stores the conserved quantity rate
-     * generated or annihilate per volume unit. Positive values mean
+     * generated or annihilated per volume unit. Positive values mean
      * that the conserved quantity is created, negative ones mean that it vanishes.
      * E.g. for the mass balance that would be a mass rate in \f$ [ kg / (m^3 \cdot s)] \f$.
      */
@@ -356,6 +356,6 @@ private:
     typename Dune::PQkLocalFiniteElementCache<Scalar, Scalar, dim, 1> feCache_;
 };
 
-} //end namespace Dumux
+} // end namespace Dumux
 
 #endif

test/porousmediumflow/1p/implicit/network1d3d/spatialparams.hh

@@ -67,7 +67,7 @@ public:
      * \brief Returns the radius of the circular pipe for the current
      * sub-control volume in [m].
      *
-     * \param scv The sub control volume
+     * \param scv The sub-control volume
      */
     Scalar radius(const SubControlVolume &scv) const
     {
@@ -81,7 +81,7 @@ public:
      * \brief Function for defining the (intrinsic) permeability \f$[m^2]\f$.
      *
      * \param element The element
-     * \param scv The sub control volume
+     * \param scv The sub-control volume
      * \param elemSol The element solution vector
      * \return The intrinsic permeability
      */