Doxygen documentation: Use C++-style comments for enumeration elements

This commit is contained in:
Henry Weller
2016-05-11 23:10:42 +01:00
parent 84f6355ad0
commit cacbc688d8
10 changed files with 42 additions and 41 deletions

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2011-2015 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2016 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -101,10 +101,10 @@ public:
//- Stop-run control options //- Stop-run control options
enum stopAtControls enum stopAtControls
{ {
saEndTime, /*!< stop when Time reaches the prescribed endTime */ saEndTime, //!< stop when Time reaches the prescribed endTime
saNoWriteNow, /*!< set endTime to stop immediately w/o writing */ saNoWriteNow, //!< set endTime to stop immediately w/o writing
saWriteNow, /*!< set endTime to stop immediately w/ writing */ saWriteNow, //!< set endTime to stop immediately w/ writing
saNextWrite /*!< stop the next time data are written */ saNextWrite //!< stop the next time data are written
}; };
//- Supported time directory name formats //- Supported time directory name formats

View File

@ -107,7 +107,7 @@ void Foam::outputFilterOutputControl::read(const dictionary& dict)
case ocClockTime: case ocClockTime:
case ocRunTime: case ocRunTime:
case ocCpuTime: case ocCpuTime:
case ocAdjustableTime: case ocAdjustableRunTime:
{ {
writeInterval_ = readScalar(dict.lookup("writeInterval")); writeInterval_ = readScalar(dict.lookup("writeInterval"));
break; break;
@ -147,7 +147,7 @@ bool Foam::outputFilterOutputControl::output()
} }
case ocRunTime: case ocRunTime:
case ocAdjustableTime: case ocAdjustableRunTime:
{ {
label outputIndex = label label outputIndex = label
( (

View File

@ -2,7 +2,7 @@
========= | ========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | \\ / O peration |
\\ / A nd | Copyright (C) 2011-2013 OpenFOAM Foundation \\ / A nd | Copyright (C) 2011-2016 OpenFOAM Foundation
\\/ M anipulation | \\/ M anipulation |
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
License License
@ -56,13 +56,13 @@ public:
//- The output control options //- The output control options
enum outputControls enum outputControls
{ {
ocTimeStep, /*!< execution is coupled to the time-step */ ocTimeStep, //!< execution is coupled to the time-step
ocOutputTime, /*!< execution is coupled to the output-time */ ocOutputTime, //!< execution is coupled to the output-time
ocAdjustableTime, /*!< Adjust time step for dumping */ ocAdjustableRunTime, //!< Adjust time step for dumping
ocRunTime, /*!< run time for dumping */ ocRunTime, //!< run time for dumping
ocClockTime, /*!< clock time for dumping */ ocClockTime, //!< clock time for dumping
ocCpuTime, /*!< cpu time for dumping */ ocCpuTime, //!< cpu time for dumping
ocNone /*!< no output */ ocNone //!< no output
}; };
@ -86,7 +86,8 @@ private:
// a value <= 1 means execute at every time step // a value <= 1 means execute at every time step
label outputInterval_; label outputInterval_;
//- Dumping counter for ocOutputTime or index dump for ocAdjustableTime //- Dumping counter for ocOutputTime or index dump
// for ocAdjustableRunTime
label outputTimeLastDump_; label outputTimeLastDump_;
//- Dump each deltaT (adjust Ttime) //- Dump each deltaT (adjust Ttime)

View File

@ -61,9 +61,9 @@ public:
//- Enumeration for handling out-of-bound values //- Enumeration for handling out-of-bound values
enum boundsHandling enum boundsHandling
{ {
ERROR, /*!< Exit with a FatalError */ ERROR, //!< Exit with a FatalError
WARN, /*!< Issue warning and clamp value (default) */ WARN, //!< Issue warning and clamp value (default)
CLAMP /*!< Clamp value to the start/end value */ CLAMP //!< Clamp value to the start/end value
}; };
//- Cconvenience typedef //- Cconvenience typedef

View File

@ -88,10 +88,10 @@ public:
//- Enumeration for handling out-of-bound values //- Enumeration for handling out-of-bound values
enum boundsHandling enum boundsHandling
{ {
ERROR, /*!< Exit with a FatalError */ ERROR, //!< Exit with a FatalError
WARN, /*!< Issue warning and clamp value (default) */ WARN, //!< Issue warning and clamp value (default)
CLAMP, /*!< Clamp value to the start/end value */ CLAMP, //!< Clamp value to the start/end value
REPEAT /*!< Treat as a repeating list */ REPEAT //!< Treat as a repeating list
}; };

View File

@ -64,10 +64,10 @@ public:
//- Enumeration for handling out-of-bound values //- Enumeration for handling out-of-bound values
enum boundsHandling enum boundsHandling
{ {
ERROR, /*!< Exit with a FatalError */ ERROR, //!< Exit with a FatalError
WARN, /*!< Issue warning and clamp value (default) */ WARN, //!< Issue warning and clamp value (default)
CLAMP, /*!< Clamp value to the start/end value */ CLAMP, //!< Clamp value to the start/end value
REPEAT /*!< Treat as a repeating list */ REPEAT //!< Treat as a repeating list
}; };

View File

@ -95,10 +95,10 @@ public:
// Note that 'REGEXP' is implicit if 'NOCASE' is specified alone. // Note that 'REGEXP' is implicit if 'NOCASE' is specified alone.
enum compOption enum compOption
{ {
LITERAL = 0, /*!< treat as a string literal */ LITERAL = 0, //!< treat as a string literal
DETECT = 1, /*!< treat as regular expression */ DETECT = 1, //!< treat as regular expression
REGEXP = 2, /*!< detect if the string contains meta-characters */ REGEXP = 2, //!< detect if the string contains meta-characters
NOCASE = 4, /*!< ignore case in regular expression */ NOCASE = 4, //!< ignore case in regular expression
DETECT_NOCASE = DETECT | NOCASE, DETECT_NOCASE = DETECT | NOCASE,
REGEXP_NOCASE = REGEXP | NOCASE REGEXP_NOCASE = REGEXP | NOCASE
}; };

View File

@ -137,9 +137,9 @@ public:
//- Enumeration for how the userdata is to be mapped upon refinement. //- Enumeration for how the userdata is to be mapped upon refinement.
enum mapType enum mapType
{ {
MASTERONLY = 1, /*!< maintain master only */ MASTERONLY = 1, //!< maintain master only
KEEPALL = 2, /*!< have slaves (upon refinement) from master */ KEEPALL = 2, //!< have slaves (upon refinement) from master
REMOVE = 4 /*!< set value to -1 any face that was refined */ REMOVE = 4 //!< set value to -1 any face that was refined
}; };

View File

@ -64,10 +64,10 @@ public:
//- Extrusion controls //- Extrusion controls
enum extrudeMode enum extrudeMode
{ {
NOEXTRUDE, /*!< Do not extrude. No layers added. */ NOEXTRUDE, //!< Do not extrude. No layers added.
EXTRUDE, /*!< Extrude */ EXTRUDE, //!< Extrude
EXTRUDEREMOVE /*!< Extrude but afterwards remove added */ EXTRUDEREMOVE //!< Extrude but afterwards remove added
/*!< faces locally */ //!< faces locally
}; };
private: private:

View File

@ -73,9 +73,9 @@ public:
//- Enumeration defining the type of action //- Enumeration defining the type of action
enum actionType enum actionType
{ {
noWriteNow, /*!< stop immediately without writing data */ noWriteNow, //!< stop immediately without writing data
writeNow, /*!< write data and stop immediately */ writeNow, //!< write data and stop immediately
nextWrite /*!< stop the next time data are written */ nextWrite //!< stop the next time data are written
}; };
private: private: