From bc4b892bc521d78810456a53f72248539f1ee594 Mon Sep 17 00:00:00 2001
From: Wenqing Wang <wenqing.wang@ufz.de>
Date: Tue, 27 Sep 2016 15:30:01 +0200
Subject: [PATCH] [Mat] Removed some keyword documentations and fixed a
 compilation error

for xcode
---
 .../Fluid/Viscosity/createViscosityModel.cpp  | 47 +++++++++----------
 .../Fluid/Viscosity/createViscosityModel.h    | 20 ++++----
 Tests/MaterialLib/TestFluidViscosity.cpp      | 22 +++++----
 3 files changed, 47 insertions(+), 42 deletions(-)

diff --git a/MaterialLib/Fluid/Viscosity/createViscosityModel.cpp b/MaterialLib/Fluid/Viscosity/createViscosityModel.cpp
index ab16fc33692..35cf825d385 100644
--- a/MaterialLib/Fluid/Viscosity/createViscosityModel.cpp
+++ b/MaterialLib/Fluid/Viscosity/createViscosityModel.cpp
@@ -1,12 +1,15 @@
-/*!
-   \file  createViscosityModel.cpp
-
-   \copyright
-    Copyright (c) 2012-2016, OpenGeoSys Community (http://www.opengeosys.org)
-               Distributed under a Modified BSD License.
-               See accompanying file LICENSE.txt or
-               http://www.opengeosys.org/project/license
-*/
+/**
+ *  \brief A function for creating viscosity model
+ *
+ *  \copyright
+ *   Copyright (c) 2012-2016, OpenGeoSys Community (http://www.opengeosys.org)
+ *              Distributed under a Modified BSD License.
+ *              See accompanying file LICENSE.txt or
+ *              http://www.opengeosys.org/project/license
+ *
+ *   \file  createViscosityModel.cpp
+ *
+ */
 
 #include "createViscosityModel.h"
 
@@ -21,11 +24,11 @@ namespace MaterialLib
 {
 namespace Fluid
 {
-/*!
-    \param config  ConfigTree object which contains the input data
-                   including  <type>fluid</type> and it has
-                   a tag of <viscosity>
-*/
+/**
+ *     \param config  ConfigTree object which contains the input data
+ *                    including  <type>fluid</type> and it has
+ *                    a tag of <viscosity>
+ */
 static std::unique_ptr<FluidProperty> createLinearPressureDependentViscosity(
     BaseLib::ConfigTree const& config)
 {
@@ -40,11 +43,11 @@ static std::unique_ptr<FluidProperty> createLinearPressureDependentViscosity(
         new LinearPressureDependentViscosity(parameters));
 }
 
-/*!
-    \param config  ConfigTree object which contains the input data
-                   including  <type>fluid</type> and it has
-                   a tag of <viscosity>
-*/
+/**
+ *     \param config  ConfigTree object which contains the input data
+ *                    including  <type>fluid</type> and it has
+ *                    a tag of <viscosity>
+ */
 static std::unique_ptr<FluidProperty> createTemperatureDependentViscosity(
     BaseLib::ConfigTree const& config)
 {
@@ -69,19 +72,15 @@ std::unique_ptr<FluidProperty> createViscosityModel(
         return std::unique_ptr<FluidProperty>(new ConstantFluidProperty(
             //! \ogs_file_param{material__fluid__viscosity__Constant__value}
             config.getConfigParameter<double>("value")));
-    //! \ogs_file_param{material__fluid__viscosity__LinearPressure}
     else if (type == "LinearPressure")
         return createLinearPressureDependentViscosity(config);
-    //! \ogs_file_param{material__fluid__viscosity__TemperatureDependent}
     else if (type == "TemperatureDependent")
         return createTemperatureDependentViscosity(config);
-    //! \ogs_file_param{material__fluid__viscosity__Vogels}
     else if (type == "Vogels")
     {
         auto const fluid_type =
             //! \ogs_file_param{material__fluid__viscosity__Vogels__fluid_type}
             config.getConfigParameter<std::string>("liquid_type");
-        //! \ogs_file_param{material__fluid__viscosity__Vogels__Water}
         if (fluid_type == "Water")
         {
             const VogelsViscosityConstantsWater constants;
@@ -89,7 +88,6 @@ std::unique_ptr<FluidProperty> createViscosityModel(
                 new VogelsLiquidDynamicViscosity<VogelsViscosityConstantsWater>(
                     constants));
         }
-        //! \ogs_file_param{material__fluid__viscosity__Vogels__CO2}
         else if (fluid_type == "CO2")
         {
             const VogelsViscosityConstantsCO2 constants;
@@ -97,7 +95,6 @@ std::unique_ptr<FluidProperty> createViscosityModel(
                 new VogelsLiquidDynamicViscosity<VogelsViscosityConstantsCO2>(
                     constants));
         }
-        //! \ogs_file_param{material__fluid__viscosity__Vogels__CH4}
         else if (fluid_type == "CH4")
         {
             const VogelsViscosityConstantsCH4 constants;
diff --git a/MaterialLib/Fluid/Viscosity/createViscosityModel.h b/MaterialLib/Fluid/Viscosity/createViscosityModel.h
index 73b1fbf017e..601a0408e47 100644
--- a/MaterialLib/Fluid/Viscosity/createViscosityModel.h
+++ b/MaterialLib/Fluid/Viscosity/createViscosityModel.h
@@ -1,12 +1,16 @@
-/*!
-   \file  createViscosityModel.h
+/**
+ *  \brief A function for creating viscosity model
+ *
+ *  \copyright
+ *   Copyright (c) 2012-2016, OpenGeoSys Community (http://www.opengeosys.org)
+ *              Distributed under a Modified BSD License.
+ *              See accompanying file LICENSE.txt or
+ *              http://www.opengeosys.org/project/license
+ *
+ *   \file  createViscosityModel.h
+ *
+ */
 
-   \copyright
-    Copyright (c) 2012-2016, OpenGeoSys Community (http://www.opengeosys.org)
-               Distributed under a Modified BSD License.
-               See accompanying file LICENSE.txt or
-               http://www.opengeosys.org/project/license
-*/
 #ifndef CREATE_VISCOSITY_MODEL_H_
 #define CREATE_VISCOSITY_MODEL_H_
 
diff --git a/Tests/MaterialLib/TestFluidViscosity.cpp b/Tests/MaterialLib/TestFluidViscosity.cpp
index c47d958e53c..1fb753d107b 100644
--- a/Tests/MaterialLib/TestFluidViscosity.cpp
+++ b/Tests/MaterialLib/TestFluidViscosity.cpp
@@ -1,16 +1,20 @@
-/*!
-   \file  TestFluidViscosity.cpp
-   \brief Test classes for fluid viscosity models.
+/**
+ *  \brief Test viscosity models
+ *
+ *  \copyright
+ *   Copyright (c) 2012-2016, OpenGeoSys Community (http://www.opengeosys.org)
+ *              Distributed under a Modified BSD License.
+ *              See accompanying file LICENSE.txt or
+ *              http://www.opengeosys.org/project/license
+ *
+ *  \file  TestFluidViscosity.cpp
+ *
+ */
 
-   \copyright
-    Copyright (c) 2012-2015, OpenGeoSys Community (http://www.opengeosys.org)
-               Distributed under a Modified BSD License.
-               See accompanying file LICENSE.txt or
-               http://www.opengeosys.org/project/license
-*/
 #include <gtest/gtest.h>
 
 #include <memory>
+#include <cmath>
 
 #include "TestTools.h"
 
-- 
GitLab