[Doxygen] Fix some incorrect/missing "@file" commands

include/cantera/Edge.h

@@ -1,3 +1,4 @@
+//! @file Edge.h
 #ifndef CXX_EDGE
 #define CXX_EDGE
 

include/cantera/GRI30.h

@@ -1,3 +1,4 @@
+//! @file GRI30.h
 #ifndef CXX_GRI30H
 #define CXX_GRI30H
 

include/cantera/IdealGasMix.h

@@ -1,3 +1,4 @@
+//! @file IdealGasMix.h
 #ifndef CXX_IDEALGASMIX
 #define CXX_IDEALGASMIX
 

include/cantera/IncompressibleSolid.h

@@ -1,3 +1,4 @@
+//! @file IncompressibleSolid.h
 #ifndef CXX_INCOMPRESSIBLE
 #define CXX_INCOMPRESSIBLE
 

include/cantera/Metal.h

@@ -1,3 +1,4 @@
+//! @file Metal.h
 #ifndef CXX_METAL
 #define CXX_METAL
 

include/cantera/PureFluid.h

@@ -1,3 +1,4 @@
+//! @file PureFluid.h
 #ifndef CXX_PUREFLUID
 #define CXX_PUREFLUID
 

include/cantera/base/Array.h

@@ -1,6 +1,5 @@
 /**
- *  @file Array.h
- *  Header file for class Array2D
+ *  @file Array.h Header file for class Cantera::Array2D
  */
 // Copyright 2001  California Institute of Technology
 

include/cantera/equil/MultiPhaseEquil.h

@@ -1,3 +1,4 @@
+//! @file MultiPhaseEquil.h
 #ifndef CT_MULTIPHASE_EQUIL
 #define CT_MULTIPHASE_EQUIL
 

include/cantera/equil/vcs_SpeciesProperties.h

@@ -1,4 +1,4 @@
-
+//! @file vcs_SpeciesProperties.h
 #ifndef VCS_SPECIES_PROPERTIES_H
 #define VCS_SPECIES_PROPERTIES_H
 

include/cantera/equil/vcs_species_thermo.h

@@ -1,3 +1,4 @@
+//! @file vcs_species_thermo.h
 
 /*
  * Copyright (2005) Sandia Corporation. Under the terms of

include/cantera/kinetics/solveSP.h

@@ -1,7 +1,6 @@
 /**
- * @file solveSP.h
- *       Header file for implicit surface problem solver
- *  (see \ref chemkinetics and class \link Cantera::solveSP solveSP\endlink).
+ * @file solveSP.h Header file for implicit surface problem solver (see \ref
+ *       chemkinetics and class \link Cantera::solveSP solveSP\endlink).
  */
 /*
  * Copyright 2004 Sandia Corporation. Under the terms of Contract

include/cantera/numerics/RootFind.h

@@ -1,7 +1,7 @@
 /**
- * @file RootFind.h
- *       Header file for implicit nonlinear solver of a one dimensional function
- *  (see \ref numerics and class \link Cantera::RootFind RootFind\endlink).
+ * @file RootFind.h Header file for implicit nonlinear solver of a one
+ *       dimensional function (see \ref numerics and class \link
+ *       Cantera::RootFind RootFind\endlink).
  */
 
 /*

include/cantera/numerics/solveProb.h

@@ -1,7 +1,7 @@
 /**
- * @file solveProb.h
- *       Header file for implicit nonlinear solver with the option of a pseudotransient
- *  (see \ref numerics and class \link Cantera::solveProb solveProb\endlink).
+ * @file solveProb.h Header file for implicit nonlinear solver with the option
+ *       of a pseudotransient (see \ref numerics and class \link
+ *       Cantera::solveProb solveProb\endlink).
  */
 
 /*

include/cantera/thermo/EdgePhase.h

@@ -1,7 +1,7 @@
 /**
- *  @file EdgePhase.h
- *       Declarations for the EdgePhase ThermoPhase object, which models the interface
- *       between two surfaces (see \ref thermoprops and \link Cantera::EdgePhase EdgePhase\endlink).
+ *  @file EdgePhase.h Declarations for the EdgePhase ThermoPhase object, which
+ *       models the interface between two surfaces (see \ref thermoprops and
+ *       \link Cantera::EdgePhase EdgePhase\endlink).
  */
 
 //  Copyright 2002 California Institute of Technology

include/cantera/thermo/IdealSolidSolnPhase.h

@@ -1,12 +1,10 @@
 /**
- * @file IdealSolidSolnPhase.h
- *      Header file for an ideal solid solution model
+ * @file IdealSolidSolnPhase.h Header file for an ideal solid solution model
  *      with incompressible thermodynamics (see \ref thermoprops and
  *      \link Cantera::IdealSolidSolnPhase IdealSolidSolnPhase\endlink).
  *
- *      This class inherits from the Cantera class ThermoPhase
- *      and implements an ideal solid solution model with incompressible
- *      thermodynamics.
+ * This class inherits from the Cantera class ThermoPhase and implements an
+ * ideal solid solution model with incompressible thermodynamics.
  */
 /*
  * Copyright 2006 Sandia Corporation. Under the terms of Contract

include/cantera/thermo/MixedSolventElectrolyte.h

@@ -1,5 +1,5 @@
 /**
- *  @file  MargulesVPSSTP.h
+ *  @file  MixedSolventElectrolyte.h
  *   Header for intermediate ThermoPhase object for phases which
  *   employ gibbs excess free energy based formulations
  *  (see \ref thermoprops

include/cantera/thermo/mix_defs.h

@@ -1,3 +1,4 @@
+//! @file mix_defs.h
 #ifndef CT_MIX_DEFS_H
 #define CT_MIX_DEFS_H
 

include/cantera/thermo/speciesThermoTypes.h

@@ -1,6 +1,5 @@
 /**
- *  @file speciesThermoTypes.h
- *       Contains const definitions for types of species
+ *  @file speciesThermoTypes.h Contains const definitions for types of species
  *       reference-state thermodynamics managers (see \ref spthermo)
  */
 // Copyright 2001  California Institute of Technology

include/cantera/tpx/Sub.h

@@ -1,3 +1,4 @@
+//! @file Sub.h
 #ifndef TPX_SUB_H
 #define TPX_SUB_H
 

include/cantera/tpx/utils.h

@@ -1,3 +1,4 @@
+//! @file utils.h
 #ifndef TPX_UTILS_H
 #define TPX_UTILS_H
 

include/cantera/transport/WaterTransport.h

@@ -1,6 +1,5 @@
 /**
- *  @file WaterTransport.h
- *   Header file defining class LiquidTransport
+ *  @file WaterTransport.h Header file defining class WaterTransport
  */
 #ifndef CT_WATERTRAN_H
 #define CT_WATERTRAN_H

src/base/application.cpp

@@ -1,3 +1,4 @@
+//! @file application.cpp
 #include "application.h"
 
 #include "cantera/base/ctexceptions.h"

src/base/application.h

@@ -1,3 +1,4 @@
+//! @file application.h
 #ifndef CT_BASE_APPLICATION_H
 #define CT_BASE_APPLICATION_H
 

src/base/ctexceptions.cpp

@@ -1,3 +1,4 @@
+//! @file ctexceptions.cpp
 #include "cantera/base/ctexceptions.h"
 
 #include "application.h"

src/base/global.cpp

@@ -1,3 +1,4 @@
+//! @file global.cpp
 #include "cantera/base/global.h"
 
 #include "cantera/base/ctexceptions.h"

src/equil/vcs_TP.cpp

@@ -1,3 +1,4 @@
+//! @file vcs_TP.cpp
 #include "cantera/equil/vcs_solve.h"
 #include "cantera/equil/vcs_internal.h"
 #include "cantera/equil/vcs_species_thermo.h"

src/equil/vcs_report.cpp

@@ -1,3 +1,4 @@
+//! @file vcs_report.cpp
 /*
  * Copyright (2005) Sandia Corporation. Under the terms of
  * Contract DE-AC04-94AL85000 with Sandia Corporation, the

src/equil/vcs_solve.cpp

@@ -1,6 +1,6 @@
 /*!
- * @file vcs_solve.h Header file for the internal class that holds the
- *     problem.
+ * @file vcs_solve.cpp Implementation file for the internal class that holds
+ *     the problem.
  */
 /*
  * Copyright (2005) Sandia Corporation. Under the terms of

src/equil/vcs_solve_phaseStability.cpp

@@ -1,7 +1,4 @@
-/**
- * @file vcs_solve_TP.cpp Implementation file that contains the
- *     main algorithm for finding an equilibrium
- */
+//! @file vcs_solve_phaseStability.cpp
 
 /*
  * Copyright (2005) Sandia Corporation. Under the terms of

src/kinetics/Kinetics.cpp

@@ -1,10 +1,10 @@
 /**
- *  @file Kinetics.cpp
- *      Declarations for the base class for kinetics
- *    managers (see \ref  kineticsmgr and class
- *  \link Cantera::Kinetics Kinetics\endlink).
+ *  @file Kinetics.cpp Declarations for the base class for kinetics managers
+ *      (see \ref  kineticsmgr and class \link Cantera::Kinetics
+ *      Kinetics\endlink).
  *
- *      Kinetics managers calculate rates of progress of species due to homogeneous or heterogeneous kinetics.
+ *  Kinetics managers calculate rates of progress of species due to
+ *  homogeneous or heterogeneous kinetics.
  */
 // Copyright 2001-2004  California Institute of Technology
 

src/numerics/DAE_solvers.cpp

@@ -1,6 +1,5 @@
 /**
- *  @file DAE_solvers.cpp
- *       Factory routine for picking the DAE solver package
+ *  @file DAE_solvers.cpp Factory routine for picking the DAE solver package
  */
 
 /*

src/numerics/Func1.cpp

@@ -1,3 +1,4 @@
+//! @file Func1.cpp
 #include "cantera/numerics/Func1.h"
 #include "cantera/base/stringUtils.h"
 #include "cantera/base/global.h"

src/numerics/ODE_integrators.cpp

@@ -1,3 +1,4 @@
+//! @file ODE_integrators.cpp
 #include "cantera/base/ct_defs.h"
 #include "cantera/numerics/Integrator.h"
 

src/numerics/RootFind.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * @file: RootFind.cpp  root finder for 1D problems
  */
 

src/numerics/SquareMatrix.cpp

@@ -1,5 +1,5 @@
 /**
- *  @file DenseMatrix.cpp
+ *  @file SquareMatrix.cpp
  */
 
 /*

src/numerics/solveProb.cpp

@@ -1,5 +1,5 @@
-/*
- * @file: solveSP.cpp Implicit solver for nonlinear problems
+/**
+ * @file: solveProb.cpp Implicit solver for nonlinear problems
  */
 
 /*

src/oneD/OneDim.cpp

@@ -1,3 +1,4 @@
+//! @file OneDim.cpp
 #include "cantera/oneD/MultiJac.h"
 #include "cantera/oneD/MultiNewton.h"
 #include "cantera/oneD/OneDim.h"

src/oneD/refine.cpp

@@ -1,3 +1,4 @@
+//! @file refine.cpp
 #include "cantera/oneD/refine.h"
 #include "cantera/oneD/Domain1D.h"
 

src/spectra/Nuclei.h

@@ -1,5 +1,5 @@
 /**
- * Provides class Nucleus
+ * @file Nuclei.h Provides class Nucleus
  */
 
 #ifndef CT_NUCL_H

src/thermo/IdealSolidSolnPhase.cpp

@@ -1,8 +1,8 @@
 /**
- *  @file IdealSolidSolnPhase.cpp
- *      Implementation file for an ideal solid solution model
- *      with incompressible thermodynamics (see \ref thermoprops and
- *      \link Cantera::IdealSolidSolnPhase IdealSolidSolnPhase\endlink).
+ *  @file IdealSolidSolnPhase.cpp Implementation file for an ideal solid
+ *      solution model with incompressible thermodynamics (see \ref
+ *      thermoprops and \link Cantera::IdealSolidSolnPhase
+ *      IdealSolidSolnPhase\endlink).
  */
 /*
  * Copyright 2006 Sandia Corporation. Under the terms of Contract

src/thermo/LatticeSolidPhase.cpp

@@ -1,7 +1,7 @@
 /**
- *  @file LatticeSolidPhase.h
+ *  @file LatticeSolidPhase.cpp
  *  Definitions for a simple thermodynamics model of a bulk solid phase
- *  derived from %ThermoPhase,
+ *  derived from ThermoPhase,
  *  assuming an ideal solution model based on a lattice of solid atoms
  *  (see \ref thermoprops and class \link Cantera::LatticeSolidPhase LatticeSolidPhase\endlink).
  */

src/thermo/MixedSolventElectrolyte.cpp

@@ -1,10 +1,9 @@
 /**
- *  @file MargulesVPSSTP.cpp
+ *  @file MixedSolventElectrolyte.cpp
  *   Definitions for ThermoPhase object for phases which
  *   employ excess gibbs free energy formulations related to Margules
  *   expansions (see \ref thermoprops
  *    and class \link Cantera::MargulesVPSSTP MargulesVPSSTP\endlink).
- *
  */
 /*
  * Copyright (2009) Sandia Corporation. Under the terms of

src/thermo/SemiconductorPhase.cpp

@@ -1,4 +1,4 @@
-
+//! @file SemiconductorPhase.cpp
 #include "cantera/thermo/SemiconductorPhase.h"
 
 using namespace std;

src/tpx/CarbonDioxide.cpp

@@ -1,9 +1,8 @@
-/* FILE: CarbonDioxide.cpp
- * DESCRIPTION:
- *  representation of substance Carbon Dioxide
- *  values and functions are from
- *  "Thermodynamic Properties in SI" by W.C. Reynolds
- * AUTHOR: me@rebeccahhunt.com: GCEP, Stanford University
+/**
+ * @file CarbonDioxide.cpp representation of substance Carbon Dioxide.
+ *
+ * Values and functions are from "Thermodynamic Properties in SI" by W.C.
+ * Reynolds AUTHOR: me@rebeccahhunt.com: GCEP, Stanford University
  */
 
 #include "CarbonDioxide.h"

src/tpx/CarbonDioxide.h

@@ -1,3 +1,4 @@
+//! @file CarbonDioxide.h
 #ifndef TPX_CARBONDIOXIDE_H
 #define TPX_CARBONDIOXIDE_H
 

src/tpx/HFC134a.cpp

@@ -1,4 +1,4 @@
-// HFC134a
+//! @file HFC134a.cpp
 
 #include "HFC134a.h"
 #include "cantera/base/stringUtils.h"

src/tpx/HFC134a.h

@@ -1,3 +1,4 @@
+//! @file HFC134a.h
 #ifndef TPX_HFC134_H
 #define TPX_HFC134_H
 

src/tpx/Heptane.cpp

@@ -1,10 +1,8 @@
-/* FILE: Heptane.cpp
- * DESCRIPTION:
- *  representation of substance Heptane
- *  values and functions are from
- *  "Thermodynamic Properties in SI" bu W.C. Reynolds
- * AUTHOR: jrh@stanford.edu: GCEP, Stanford University
+/**
+ * @file Heptane.cpp representation of substance Heptane.
  *
+ * Values and functions are from "Thermodynamic Properties in SI" by W.C.
+ * Reynolds. AUTHOR: jrh@stanford.edu: GCEP, Stanford University
  */
 
 #include "Heptane.h"

src/tpx/Heptane.h

@@ -1,3 +1,4 @@
+//! @file Heptane.h
 #ifndef TPX_HEPTANE_H
 #define TPX_HEPTANE_H
 

src/tpx/Hydrogen.cpp

@@ -1,3 +1,4 @@
+//! @file Hydrogen.cpp
 #include "Hydrogen.h"
 #include "cantera/base/stringUtils.h"
 

src/tpx/Hydrogen.h

@@ -1,3 +1,4 @@
+//! @file Hydrogen.h
 #ifndef TPX_HYDROGEN_H
 #define TPX_HYDROGEN_H
 

src/tpx/Methane.cpp

@@ -1,3 +1,4 @@
+//! @file Methane.cpp
 #include "Methane.h"
 #include "cantera/base/stringUtils.h"
 

src/tpx/Methane.h

@@ -1,3 +1,4 @@
+//! @file Methane.h
 #ifndef TPX_METHANE_H
 #define TPX_METHANE_H
 

src/tpx/Nitrogen.cpp

@@ -1,3 +1,4 @@
+//! @file Nitrogen.cpp
 #include "Nitrogen.h"
 #include "cantera/base/stringUtils.h"
 

src/tpx/Nitrogen.h

@@ -1,4 +1,4 @@
-
+//! @file Nitrogen.h
 #ifndef TPX_NITROGEN_H
 #define TPX_NITROGEN_H
 

src/tpx/Oxygen.cpp

@@ -1,3 +1,4 @@
+//! @file Oxygen.cpp
 #include "Oxygen.h"
 #include "cantera/base/stringUtils.h"
 

src/tpx/Oxygen.h

@@ -1,3 +1,4 @@
+//! @file Oxygen.h
 #ifndef TPX_OXYGEN_H
 #define TPX_OXYGEN_H
 

src/tpx/RedlichKwong.cpp

@@ -1,3 +1,4 @@
+//! @file RedlichKwong.cpp
 #include "RedlichKwong.h"
 
 namespace tpx

src/tpx/RedlichKwong.h

@@ -1,3 +1,4 @@
+//! @file RedlichKwong.h
 #ifndef TPX_RK_H
 #define TPX_RK_H
 

src/tpx/Sub.cpp

@@ -1,3 +1,4 @@
+//! @file Sub.cpp
 /*
  * The Substance class
  * D. Goodwin, Caltech Nov. 1996

src/tpx/Water.cpp

@@ -1,3 +1,4 @@
+//! @file Water.cpp
 #include "Water.h"
 #include "cantera/base/stringUtils.h"
 

src/tpx/Water.h

@@ -1,3 +1,4 @@
+//! @file Water.h
 #ifndef TPX_WATER_H
 #define TPX_WATER_H
 

src/tpx/lk.cpp

@@ -1,4 +1,4 @@
-// Lee-Kesler equation of state
+//! @file lk.cpp Lee-Kesler equation of state
 
 #include "lk.h"
 #include <math.h>

src/tpx/lk.h

@@ -1,3 +1,4 @@
+//! @file lk.h Lee-Kesler equation of state
 #ifndef TPX_LK_H
 #define TPX_LK_H
 

src/tpx/utils.cpp

@@ -1,3 +1,4 @@
+//! @file utils.cpp
 #include "cantera/tpx/utils.h"
 #include "cantera/base/stringUtils.h"
 

src/transport/GasTransport.cpp

@@ -1,3 +1,4 @@
+//! @file GasTransport.cpp
 #include "cantera/transport/GasTransport.h"
 #include "cantera/transport/TransportParams.h"
 

src/transport/LiquidTranInteraction.cpp

@@ -1,5 +1,5 @@
 /**
- *  @file LiquidTransportParams.cpp
+ *  @file LiquidTranInteraction.cpp
  *  Source code for liquid mixture transport property evaluations.
  */
 

src/transport/WaterTransport.cpp

@@ -1,3 +1,4 @@
+//! @file WaterTransport.cpp
 #include "cantera/base/ct_defs.h"
 #include "cantera/thermo/WaterPropsIAPWS.h"
 #include "cantera/transport/TransportBase.h"

src/zeroD/FlowDevice.cpp

@@ -1,3 +1,4 @@
+//! @file FlowDevice.cpp
 #include "cantera/zeroD/FlowDevice.h"
 #include "cantera/zeroD/ReactorBase.h"
 #include "cantera/numerics/Func1.h"

src/zeroD/ReactorNet.cpp

@@ -1,3 +1,4 @@
+//! @file ReactorNet.cpp
 #include "cantera/zeroD/ReactorNet.h"
 #include "cantera/numerics/Integrator.h"
 #include "cantera/zeroD/FlowDevice.h"

src/zeroD/Wall.cpp

@@ -1,3 +1,4 @@
+//! @file Wall.cpp
 #include "cantera/zeroD/Wall.h"
 #include "cantera/zeroD/ReactorBase.h"
 #include "cantera/zeroD/ReactorNet.h"