diff --git a/applications/solvers/multiphase/icoReactingMultiphaseInterFoam/phasesSystem/phasePair/phasePair/phasePair.H b/applications/solvers/multiphase/icoReactingMultiphaseInterFoam/phasesSystem/phasePair/phasePair/phasePair.H index 413bda2b045fb7e9cf44031e65406c7182a9adb2..02dd12e2b1cda1ab4627f256853befa35f658264 100644 --- a/applications/solvers/multiphase/icoReactingMultiphaseInterFoam/phasesSystem/phasePair/phasePair/phasePair.H +++ b/applications/solvers/multiphase/icoReactingMultiphaseInterFoam/phasesSystem/phasePair/phasePair/phasePair.H @@ -22,11 +22,11 @@ License along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>. Class - Foam::phasePair description for mass transfer between a pair of - phases. The direction of the mass transfer is from the phase - 'from' to the phasse 'to'. + Foam::phasePair Description + Description for mass transfer between a pair of phases. The direction of + the mass transfer is from the phase 'from' to the phasse 'to'. SourceFiles phasePair.C diff --git a/src/OpenFOAM/containers/Bits/PackedList/PackedList.H b/src/OpenFOAM/containers/Bits/PackedList/PackedList.H index 700ffb6db5272b9d7d92f80ee3fcc9b256b33d0c..bfd1dc4f7797792e1163550bd7f6b6393e4804a9 100644 --- a/src/OpenFOAM/containers/Bits/PackedList/PackedList.H +++ b/src/OpenFOAM/containers/Bits/PackedList/PackedList.H @@ -155,7 +155,7 @@ public: // \code // (numElem / elem_per_block) // + (numElem % elem_per_block) ? 1 : 0 - // \code + // \endcode // But avoiding the modulus operation static constexpr label num_blocks(label numElem) { @@ -471,7 +471,6 @@ public: Ostream& os, const PackedList<Width>& list ); - }; diff --git a/src/OpenFOAM/db/functionObjects/functionObject/functionObject.H b/src/OpenFOAM/db/functionObjects/functionObject/functionObject.H index 6bd43b8c9e6c82cf4c679a6fd695d5a71b866daf..7d19a907caed6019f23de4e0ec1e6441ccf53790 100644 --- a/src/OpenFOAM/db/functionObjects/functionObject/functionObject.H +++ b/src/OpenFOAM/db/functionObjects/functionObject/functionObject.H @@ -32,7 +32,7 @@ Description field and derived quantities. Alternatively, the same actions can be executed after the simulation using the \c -postProcess command-line option. - \subsection secFunctionObjects Using function objects + \section secFunctionObjects Using function objects FunctionObjects are selected by additional entries in the $FOAM_CASE/system/controlDict dictionary. Each object is listed in the \c diff --git a/src/OpenFOAM/global/fileOperations/collatedFileOperation/hostCollatedFileOperation.H b/src/OpenFOAM/global/fileOperations/collatedFileOperation/hostCollatedFileOperation.H index 4d61b622b241602208d1391d8bcf7c2e6d3dcf91..9571c3d67fe6b41c041f02eeeccd408be40d810a 100644 --- a/src/OpenFOAM/global/fileOperations/collatedFileOperation/hostCollatedFileOperation.H +++ b/src/OpenFOAM/global/fileOperations/collatedFileOperation/hostCollatedFileOperation.H @@ -29,9 +29,9 @@ Description In parallel it will assume ranks are sorted according to hostname and the lowest rank per hostname will be the IO rank. The output directories - will get a unique name processors<N>_<low>-<high> where N is the overall - number of processors and low and high is the range of ranks contained - in the files. Each of these subsets uses its own communicator. + will get a unique name processors\<N\>_\<low\>-\<high\> where N is the + overall number of processors and low and high is the range of ranks + contained in the files. Each of these subsets uses its own communicator. Instead of using the hostnames the IO ranks can be assigned using the FOAM_IORANKS environment variable (also when running non-parallel), e.g. diff --git a/src/OpenFOAM/global/fileOperations/masterUncollatedFileOperation/masterUncollatedFileOperation.H b/src/OpenFOAM/global/fileOperations/masterUncollatedFileOperation/masterUncollatedFileOperation.H index 77eba09a7c75a6d25a08e68d89a65a988d885fb7..b709d3fba0a6217679fa4923f42370dd6736f8ff 100644 --- a/src/OpenFOAM/global/fileOperations/masterUncollatedFileOperation/masterUncollatedFileOperation.H +++ b/src/OpenFOAM/global/fileOperations/masterUncollatedFileOperation/masterUncollatedFileOperation.H @@ -28,8 +28,9 @@ Description fileOperations that performs all file operations on the master processor. Requires the calls to be parallel synchronised! - Limitations: - no /processor in filename - - no /uniform/ in the filename + Limitations + - no /processor in filename + - no /uniform/ in the filename The main logic is in ::filePath which returns a - same path on all processors. This can either be a global file @@ -40,12 +41,12 @@ Description - different path on all processors (processor0/0/p) system/controlDict: - filePath worldmaster: <globalRoot>/system/controlDict + filePath worldmaster: \<globalRoot\>/system/controlDict localmaster: ,, slave : ,, processor0/uniform/time - filePath worldmaster: <globalRoot>/processorXXX/uniform/time + filePath worldmaster: \<globalRoot\>/processorXXX/uniform/time localmaster: ,, slave : ,, diff --git a/src/OpenFOAM/meshes/polyMesh/zones/ZoneMesh/ZoneMesh.H b/src/OpenFOAM/meshes/polyMesh/zones/ZoneMesh/ZoneMesh.H index 59d1d220526ee53ac4fb838442d5d9a79d2da2ff..94e03c1575683e9f32cd5d87dfbdbaa06ece030b 100644 --- a/src/OpenFOAM/meshes/polyMesh/zones/ZoneMesh/ZoneMesh.H +++ b/src/OpenFOAM/meshes/polyMesh/zones/ZoneMesh/ZoneMesh.H @@ -231,6 +231,7 @@ public: // // if (nOrig == zones.size()) { existing... } else { new... } // \endcode + // \param zoneName the name of the zone // \param verbose report if an existing zone was selected or // a new zone was created. // \return non-const reference to the existing or new zone diff --git a/src/OpenFOAM/primitives/functions/Function1/Table/Table.H b/src/OpenFOAM/primitives/functions/Function1/Table/Table.H index ae7066f96e537721740bbe5064b20d0defcc45b3..d46a53e00b09c49533c5e7a31548cb38c3cb3d53 100644 --- a/src/OpenFOAM/primitives/functions/Function1/Table/Table.H +++ b/src/OpenFOAM/primitives/functions/Function1/Table/Table.H @@ -86,6 +86,12 @@ public: //- Copy constructor explicit Table(const Table<Type>& tbl); + //- Construct and return a clone + virtual tmp<Function1<Type>> clone() const + { + return tmp<Function1<Type>>(new Table<Type>(*this)); + } + //- Destructor virtual ~Table(); diff --git a/src/OpenFOAM/primitives/strings/stringOps/stringOps.H b/src/OpenFOAM/primitives/strings/stringOps/stringOps.H index 6a483affa24209994927684b74146a01b59760b2..85414c90087dd1d612e762837735849b0328d2da 100644 --- a/src/OpenFOAM/primitives/strings/stringOps/stringOps.H +++ b/src/OpenFOAM/primitives/strings/stringOps/stringOps.H @@ -218,10 +218,10 @@ namespace stringOps // -# current directory // - leading "./" : the current directory // -# leading tag expansion for commonly used directories - // - <etc>/ : user/group/other OpenFOAM directory - // - <case>/ : FOAM_CASE directory - // - <constant>/ : FOAM_CASE/constant directory - // - <system>/ : FOAM_CASE/system directory + // - \<etc\>/ : user/group/other OpenFOAM directory + // - \<case\>/ : FOAM_CASE directory + // - \<constant\>/ : FOAM_CASE/constant directory + // - \<system\>/ : FOAM_CASE/system directory // -# tilde expansion // - leading "~/" : home directory // - leading "~user" : home directory for specified user @@ -258,10 +258,10 @@ namespace stringOps // -# current directory // - leading "./" : the current directory // -# leading tag expansion for commonly used directories - // - <etc>/ : user/group/other OpenFOAM directory - // - <case>/ : FOAM_CASE directory - // - <constant>/ : FOAM_CASE/constant directory - // - <system>/ : FOAM_CASE/system directory + // - \<etc\>/ : user/group/other OpenFOAM directory + // - \<case\>/ : FOAM_CASE directory + // - \<constant\>/ : FOAM_CASE/constant directory + // - \<system\>/ : FOAM_CASE/system directory // -# tilde expansion // - leading "~/" : home directory // - leading "~user" : home directory for specified user diff --git a/src/combustionModels/EDC/EDC.H b/src/combustionModels/EDC/EDC.H index 5cda96b6f6ede430ca60f8042228546d4c91cb39..fdddde56be428e28c3df9a248bd5926ff54a010b 100644 --- a/src/combustionModels/EDC/EDC.H +++ b/src/combustionModels/EDC/EDC.H @@ -35,7 +35,7 @@ Description There are many versions and developments of the EDC model, 4 of which are currently supported in this implementation: v1981, v1996, v2005 and v2016. The model variant is selected using the optional \c version entry in - the \c EDCCoeffs dictionary, \eg + the \c EDCCoeffs dictionary, e.g. \verbatim EDCCoeffs diff --git a/src/finiteVolume/cfdTools/general/solutionControl/loopControl/loopControl.H b/src/finiteVolume/cfdTools/general/solutionControl/loopControl/loopControl.H index 2190a00502d378d934cf58c2e418d70973124850..42b206080f651870cb1230e444963c4c50c6e906 100644 --- a/src/finiteVolume/cfdTools/general/solutionControl/loopControl/loopControl.H +++ b/src/finiteVolume/cfdTools/general/solutionControl/loopControl/loopControl.H @@ -45,6 +45,7 @@ Usage } } } + \endverbatim Where the loop entries comprise: \table diff --git a/src/finiteVolume/fields/fvPatchFields/derived/turbulentDFSEMInlet/turbulentDFSEMInletFvPatchVectorField.H b/src/finiteVolume/fields/fvPatchFields/derived/turbulentDFSEMInlet/turbulentDFSEMInletFvPatchVectorField.H index 2903f2002b8a8f4d9c7212fcdc31e735ce2e0274..31767113fe24b5bcd819d23b9f6565c97e1ae36f 100644 --- a/src/finiteVolume/fields/fvPatchFields/derived/turbulentDFSEMInlet/turbulentDFSEMInletFvPatchVectorField.H +++ b/src/finiteVolume/fields/fvPatchFields/derived/turbulentDFSEMInlet/turbulentDFSEMInletFvPatchVectorField.H @@ -45,8 +45,8 @@ Description except that no interpolation in time is supported. These should be located in the directory: - \$FOAM_CASE/constant/boundaryData/<patchName>/points - \$FOAM_CASE/constant/boundaryData/<patchName>/0/\{R|U|L\} + \$FOAM_CASE/constant/boundaryData/\<patchName\>/points + \$FOAM_CASE/constant/boundaryData/\<patchName\>/0/\{R|U|L\} Usage diff --git a/src/functionObjects/field/CourantNo/CourantNo.H b/src/functionObjects/field/CourantNo/CourantNo.H index 26c467525e393e10557ad13a769e60a7d24bfb0a..f65e61048cb0611b48511ede31619836ca12fb49 100644 --- a/src/functionObjects/field/CourantNo/CourantNo.H +++ b/src/functionObjects/field/CourantNo/CourantNo.H @@ -49,7 +49,7 @@ Usage type | Type name: CourantNo | yes | rho | Name of density field | no | rho field | Name of flux field | no | phi - result | Name of Courant number field | no | <function name> + result | Name of Courant number field | no | \<function name\> log | Log to standard output | no | yes \endtable diff --git a/src/functionObjects/field/DESModelRegions/DESModelRegions.H b/src/functionObjects/field/DESModelRegions/DESModelRegions.H index 8119b9d738b75345cb08172750262d7c8964d5a6..6223bcb4a43e4e4a9bbaaa6d33a95cc833860349 100644 --- a/src/functionObjects/field/DESModelRegions/DESModelRegions.H +++ b/src/functionObjects/field/DESModelRegions/DESModelRegions.H @@ -51,7 +51,7 @@ Usage \table Property | Description | Required | Default value type | type name: DESModelRegions| yes | - resultName | Name of DES indicator field | no | <function name> + resultName | Name of DES indicator field | no | \<function name\> log | log to standard output | no | yes \endtable diff --git a/src/functionObjects/field/PecletNo/PecletNo.H b/src/functionObjects/field/PecletNo/PecletNo.H index bb6bf485970f5413503d2c6715b5f44f5c0f5740..a52904fff5a13f9f31967da9d435558fd0c75087 100644 --- a/src/functionObjects/field/PecletNo/PecletNo.H +++ b/src/functionObjects/field/PecletNo/PecletNo.H @@ -47,7 +47,7 @@ Usage type | type name: Peclet | yes | phi | Name of flux field | no | phi rho | Name of density field | no | rho - result | Name of Peclet field | no | <function name> + result | Name of Peclet field | no | \<function name\> log | Log to standard output | no | yes \endtable diff --git a/src/functionObjects/field/Q/Q.H b/src/functionObjects/field/Q/Q.H index ca2cc1b7445447483ff3945b7c6d6d754d52f384..4bf3a08199e7b828f5d6e45c1a60528488cfbbcb 100644 --- a/src/functionObjects/field/Q/Q.H +++ b/src/functionObjects/field/Q/Q.H @@ -56,7 +56,7 @@ Usage Property | Description | Required | Default value type | type name: Q | yes | U | Name of velocity field | no | U - result | Name of Q field | no | <function name> + result | Name of Q field | no | \<function name\> log | Log to standard output | no | yes \endtable diff --git a/src/functionObjects/field/blendingFactor/blendingFactor.H b/src/functionObjects/field/blendingFactor/blendingFactor.H index cac6b782d9e59c7994e59398d775a6e1ba67d69d..4db4dec3d0c0d59c673bc5a4c93f136a83eb3fb7 100644 --- a/src/functionObjects/field/blendingFactor/blendingFactor.H +++ b/src/functionObjects/field/blendingFactor/blendingFactor.H @@ -42,7 +42,7 @@ Description The factor is a face-based quantity, which is converted to a cell-based quantity by assigning the minimum blending factor for any cell face. - An indicator (volume) field, named <functionObjectName>:<fieldName>, is + An indicator (volume) field, named \<functionObjectName\>:\<fieldName\>, is generated that is set to (1 - f), i.e. values of: - 0 represent scheme1 as active, and - 1 represent scheme2 as active. diff --git a/src/functionObjects/field/fluxSummary/fluxSummary.H b/src/functionObjects/field/fluxSummary/fluxSummary.H index 1677d826a01da850b479679ef016e2ad8a970e34..324ce7c4733cff016776a8fcae7f11f3e666d3d4 100644 --- a/src/functionObjects/field/fluxSummary/fluxSummary.H +++ b/src/functionObjects/field/fluxSummary/fluxSummary.H @@ -71,7 +71,7 @@ Usage - surface - surfaceAndDirection - Output data is written to files of the form \<timeDir\>/<faceZoneName>.dat + Output data is written to files of the form \<timeDir\>/\<faceZoneName\>.dat See also Foam::functionObjects::fvMeshFunctionObject diff --git a/src/functionObjects/field/mapFields/mapFields.H b/src/functionObjects/field/mapFields/mapFields.H index fa5fc85151a156e1bfa970eae377e1d45ed80159..4d80b1baa77293b8773f18e752bac4ee864b3d45 100644 --- a/src/functionObjects/field/mapFields/mapFields.H +++ b/src/functionObjects/field/mapFields/mapFields.H @@ -53,7 +53,7 @@ Usage type | Type name: mapFields | yes | mapRegion | Name of region to map to | yes | mapMethod | Mapping method | yes | - patchMapMethod | Patch mapping method | no | <auto> + patchMapMethod | Patch mapping method | no | \<auto\> consistent | Mapping meshes have consistent boundaries | yes | fields | List of field names to map | yes | log | Log to standard output | no | yes diff --git a/src/functionObjects/field/reference/reference.H b/src/functionObjects/field/reference/reference.H index 07621cdd6edda91aa06f120df98f4b09e4c3f3cd..d1dd0c36f4528103aed09ea99231c524b58e7f11 100644 --- a/src/functionObjects/field/reference/reference.H +++ b/src/functionObjects/field/reference/reference.H @@ -67,8 +67,8 @@ Usage Property | Description | Required | Default value type | Type name: reference | yes | field | Name of field | yes | - result | Name of result field | no | reference(<field>) - position | Position to sample | no | <not used> + result | Name of result field | no | reference(\<field\>) + position | Position to sample | no | \<not used\> scale | Scale value | no | 1 offset | Offset value | no | zero log | Log to standard output | no | yes diff --git a/src/functionObjects/field/stabilityBlendingFactor/stabilityBlendingFactor.H b/src/functionObjects/field/stabilityBlendingFactor/stabilityBlendingFactor.H index 98776a4d2a7748c1efa3503af442a4d9c124a31f..9d58a323fd29b53e3f0c0ad1fa74e364a6c10c83 100644 --- a/src/functionObjects/field/stabilityBlendingFactor/stabilityBlendingFactor.H +++ b/src/functionObjects/field/stabilityBlendingFactor/stabilityBlendingFactor.H @@ -63,7 +63,7 @@ Description ), 1.0 ) - \f[ + \f] For option 2, the following relation is used: \f[ @@ -78,7 +78,7 @@ Description ), 1.0 ) - \f[ + \f] Note that magGradCC is equal to 3 for ortoghonal meshes For option 3 a PID control is used in order to control residual @@ -89,14 +89,14 @@ Description P*residual + I*residualIntegral + D*residualDifferential - \f[ + \f] where P, I and D are user inputs The following relation is used: \f[ fRes = (factor - meanRes)/(maxRes*meanRes); - \f[ + \f] where: meanRes = average(residual) @@ -120,7 +120,7 @@ Description ), 1.0 ) - \f[ + \f] Note that faceWeights for a orthogonal mesh is 0.5. @@ -138,7 +138,7 @@ Description ), 1.0 ) - \f[ + \f] For option 6 , the following relation is used: @@ -275,8 +275,7 @@ Usage tolerance | Tolerance for number of blended cells | no | 0.001 field | Name of field to evaluate | yes | result | Name of surface field to be used in the localBlended scheme - | yes - + | yes | \endtable The 'log' flag true write the number of cells on each scheme, plus it diff --git a/src/functionObjects/solvers/scalarTransport/scalarTransport.H b/src/functionObjects/solvers/scalarTransport/scalarTransport.H index df11dabe423b514869bef07529a6fadc370e4b97..bed7201e690b36c2b975043fb7a03c3ac5c1535e 100644 --- a/src/functionObjects/solvers/scalarTransport/scalarTransport.H +++ b/src/functionObjects/solvers/scalarTransport/scalarTransport.H @@ -48,6 +48,7 @@ Description Usage Example of function object specification to solve a scalar transport equation: + \verbatim functions { scalar1 diff --git a/src/overset/include/setCellMask.H b/src/overset/include/setCellMask.H index 92e187ee596f479ba49351ddd8cbad4eb4f97de7..1a57b79b6685b39ff967e43bd298ba4ca166fadb 100644 --- a/src/overset/include/setCellMask.H +++ b/src/overset/include/setCellMask.H @@ -21,13 +21,9 @@ License You should have received a copy of the GNU General Public License along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>. -Class - Description Sets blocked cells mask field -SourceFiles - \*---------------------------------------------------------------------------*/ { diff --git a/src/overset/include/setInterpolatedCells.H b/src/overset/include/setInterpolatedCells.H index 6b3cac9e85429103105673de250153f7285bbe8d..d33755e96a2c5fd59c400911849c69b4262a6764 100644 --- a/src/overset/include/setInterpolatedCells.H +++ b/src/overset/include/setInterpolatedCells.H @@ -21,13 +21,9 @@ License You should have received a copy of the GNU General Public License along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>. -Class - Description Sets blocked cells mask field -SourceFiles - \*---------------------------------------------------------------------------*/ {