diff --git a/src/TurbulenceModels/compressible/turbulentFluidThermoModels/derivedFvPatchFields/externalWallHeatFluxTemperature/externalWallHeatFluxTemperatureFvPatchScalarField.H b/src/TurbulenceModels/compressible/turbulentFluidThermoModels/derivedFvPatchFields/externalWallHeatFluxTemperature/externalWallHeatFluxTemperatureFvPatchScalarField.H
index 241f673ad751a51f45b7ca9287f5029c12e01e90..2f9b112d2eb13536b554970199e24a351e217639 100644
--- a/src/TurbulenceModels/compressible/turbulentFluidThermoModels/derivedFvPatchFields/externalWallHeatFluxTemperature/externalWallHeatFluxTemperatureFvPatchScalarField.H
+++ b/src/TurbulenceModels/compressible/turbulentFluidThermoModels/derivedFvPatchFields/externalWallHeatFluxTemperature/externalWallHeatFluxTemperatureFvPatchScalarField.H
@@ -34,8 +34,8 @@ Description
     fixed heat transfer coefficient mode.
 
     The condition can operate in two modes:
-    - fixed heat transfer coefficient: supply h and Ta
-    - fixed heat flux: supply q
+      - fixed heat transfer coefficient: supply h and Ta
+      - fixed heat flux: supply q
 
     where:
     \vartable
@@ -48,7 +48,6 @@ Description
     mesh database using the \c lookup option, or from a \c solidThermo
     thermophysical package.
 
-
     \heading Patch usage
 
     \table
@@ -83,9 +82,8 @@ Description
     \endverbatim
 
     Note:
-
-    \li Only supply \c h and \c Ta, or \c q in the dictionary (see above)
-    \li \c kappa and \c kappaName are inherited from temperatureCoupledBase.
+      - Only supply \c h and \c Ta, or \c q in the dictionary (see above)
+      - \c kappa and \c kappaName are inherited from temperatureCoupledBase.
 
 SeeAlso
     Foam::temperatureCoupledBase
diff --git a/src/TurbulenceModels/compressible/turbulentFluidThermoModels/derivedFvPatchFields/turbulentTemperatureCoupledBaffleMixed/turbulentTemperatureCoupledBaffleMixedFvPatchScalarField.H b/src/TurbulenceModels/compressible/turbulentFluidThermoModels/derivedFvPatchFields/turbulentTemperatureCoupledBaffleMixed/turbulentTemperatureCoupledBaffleMixedFvPatchScalarField.H
index ffe99ac734eebf0ad41907d2a9d7535db28f4d23..a786c74babc0c2462ccbb3040495fb2ca869f2ec 100644
--- a/src/TurbulenceModels/compressible/turbulentFluidThermoModels/derivedFvPatchFields/turbulentTemperatureCoupledBaffleMixed/turbulentTemperatureCoupledBaffleMixedFvPatchScalarField.H
+++ b/src/TurbulenceModels/compressible/turbulentFluidThermoModels/derivedFvPatchFields/turbulentTemperatureCoupledBaffleMixed/turbulentTemperatureCoupledBaffleMixedFvPatchScalarField.H
@@ -36,9 +36,9 @@ Description
 
     Specifies gradient and temperature such that the equations are the same
     on both sides:
-    - refGradient = zero gradient
-    - refValue = neighbour value
-    - mixFraction = nbrKDelta / (nbrKDelta + myKDelta())
+      - refGradient = zero gradient
+      - refValue = neighbour value
+      - mixFraction = nbrKDelta / (nbrKDelta + myKDelta())
 
     where KDelta is heat-transfer coefficient K * deltaCoeffs
 
@@ -70,8 +70,7 @@ Description
     Needs to be on underlying mapped(Wall)FvPatch.
 
     Note:
-
-    \li \c kappa and \c kappaName are inherited from temperatureCoupledBase.
+      - \c kappa and \c kappaName are inherited from temperatureCoupledBase.
 
 
 SeeAlso
diff --git a/src/TurbulenceModels/compressible/turbulentFluidThermoModels/derivedFvPatchFields/turbulentTemperatureRadCoupledMixed/turbulentTemperatureRadCoupledMixedFvPatchScalarField.H b/src/TurbulenceModels/compressible/turbulentFluidThermoModels/derivedFvPatchFields/turbulentTemperatureRadCoupledMixed/turbulentTemperatureRadCoupledMixedFvPatchScalarField.H
index 9a22101405498f62b539b5279483f0afeba84685..64290d47419930cb5713d56fb25daeec999a54c1 100644
--- a/src/TurbulenceModels/compressible/turbulentFluidThermoModels/derivedFvPatchFields/turbulentTemperatureRadCoupledMixed/turbulentTemperatureRadCoupledMixedFvPatchScalarField.H
+++ b/src/TurbulenceModels/compressible/turbulentFluidThermoModels/derivedFvPatchFields/turbulentTemperatureRadCoupledMixed/turbulentTemperatureRadCoupledMixedFvPatchScalarField.H
@@ -67,8 +67,7 @@ Description
     Needs to be on underlying mapped(Wall)FvPatch.
 
     Note:
-
-    \li \c kappa and \c kappaName are inherited from temperatureCoupledBase.
+      - \c kappa and \c kappaName are inherited from temperatureCoupledBase.
 
 
 SeeAlso
diff --git a/src/functionObjects/utilities/writeObjects/writeObjects.H b/src/functionObjects/utilities/writeObjects/writeObjects.H
index db39de97db8dabfc3f36620cdaef8026b0102259..baae5bb5700d31ac3f3847b4702ef4dcf36c4a7f 100644
--- a/src/functionObjects/utilities/writeObjects/writeObjects.H
+++ b/src/functionObjects/utilities/writeObjects/writeObjects.H
@@ -29,22 +29,23 @@ Group
 
 Description
     This function object allows specification of different writing frequency
-    of objects registered to the database. It has similar functionality
-    as the main time database through the writeControl setting:
+    of objects registered to the database.
 
-    \li \c timeStep
-    \li \c writeTime
-    \li \c adjustableRunTime
-    \li \c runTime
-    \li \c clockTime
-    \li \c cpuTime
+    It has similar functionality as the main time database through the
+    writeControl setting:
+      - timeStep
+      - writeTime
+      - adjustableRunTime
+      - runTime
+      - clockTime
+      - cpuTime
 
     Example of function object specification:
     \verbatim
     writeObjects1
     {
         type        writeObjects;
-        libs ("libutilityFunctionObjects.so");
+        libs        ("libutilityFunctionObjects.so");
         exclusiveWriting     true;
         ...
         objectNames (obj1 obj2);
diff --git a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/CellZoneInjection/CellZoneInjection.H b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/CellZoneInjection/CellZoneInjection.H
index c5cb05a957c6a0ea5c154742e9d4accf2a12b3bd..9213037ee9f4765d5dada4d75fe6a87782034501 100644
--- a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/CellZoneInjection/CellZoneInjection.H
+++ b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/CellZoneInjection/CellZoneInjection.H
@@ -28,14 +28,14 @@ Description
     Injection positions specified by a particle number density within a cell
     set.
 
-    \li User specifies:
-        - Number density of particles in cell set (effective)
-        - Total mass to inject
-        - Initial parcel velocity
-
-    \li Parcel diameters obtained by PDF model
-
-    \li All parcels introduced at SOI
+    User specifies:
+      - Number density of particles in cell set (effective)
+      - Total mass to inject
+      - Initial parcel velocity
+
+    Properties:
+      - Parcel diameters obtained by PDF model
+      - All parcels introduced at SOI
 
 SourceFiles
     CellZoneInjection.C
diff --git a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/ConeInjection/ConeInjection.H b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/ConeInjection/ConeInjection.H
index bacfaaa9977f2d17b0117f680d8c27c813d86ee2..a482be6af8ac30ddb02ea040a7cd92e384695f57 100644
--- a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/ConeInjection/ConeInjection.H
+++ b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/ConeInjection/ConeInjection.H
@@ -27,14 +27,15 @@ Class
 Description
     Multi-point cone injection model.
 
-    \li User specifies:
-        - time of start of injection
-        - list of injector positions and directions (along injection axes)
-        - number of parcels to inject per injector
-        - parcel velocities
-        - inner and outer half-cone angles
-
-    \li Parcel diameters obtained by distribution model
+    User specifies:
+      - time of start of injection
+      - list of injector positions and directions (along injection axes)
+      - number of parcels to inject per injector
+      - parcel velocities
+      - inner and outer half-cone angles
+
+    Properties:
+      - Parcel diameters obtained by distribution model
 
 SourceFiles
     ConeInjection.C
diff --git a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/ConeNozzleInjection/ConeNozzleInjection.H b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/ConeNozzleInjection/ConeNozzleInjection.H
index 6a29c1cc1d4300871618cfc1f89c15a07508fca2..5d7e34f11800e9a90f3349cadc2d86e759803055 100644
--- a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/ConeNozzleInjection/ConeNozzleInjection.H
+++ b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/ConeNozzleInjection/ConeNozzleInjection.H
@@ -27,30 +27,31 @@ Class
 Description
     Cone injection.
 
-    \li User specifies:
-        - time of start of injection
-        - injector position
-        - direction (along injection axis)
-        - parcel flow rate
-        - inner and outer half-cone angles
+    User specifies:
+      - time of start of injection
+      - injector position
+      - direction (along injection axis)
+      - parcel flow rate
+      - inner and outer half-cone angles
 
-    \li Parcel diameters obtained by size distribution model
+    Properties:
+      - Parcel diameters obtained by size distribution model.
 
-    \li Parcel velocity is calculated as:
+      - Parcel velocity is calculated as:
         - Constant velocity:
-        \verbatim
-        U = \<specified by user\>
-        \endverbatim
+          \verbatim
+          U = \<specified by user\>
+          \endverbatim
 
         - Pressure driven velocity:
-        \verbatim
-        U = sqrt(2*(Pinj - Pamb)/rho)
-        \endverbatim
+          \verbatim
+          U = sqrt(2*(Pinj - Pamb)/rho)
+          \endverbatim
 
         - Flow rate and discharge:
-        \verbatim
-        U = V_dot/(A*Cd)
-        \endverbatim
+          \verbatim
+          U = V_dot/(A*Cd)
+          \endverbatim
 
 SourceFiles
     ConeNozzleInjection.C
diff --git a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/FieldActivatedInjection/FieldActivatedInjection.H b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/FieldActivatedInjection/FieldActivatedInjection.H
index 986f1b46b80bb991356c3cbd0d8bac287339dd10..c55ebc829b61cc12442a4149c799a2f40521a428 100644
--- a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/FieldActivatedInjection/FieldActivatedInjection.H
+++ b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/FieldActivatedInjection/FieldActivatedInjection.H
@@ -27,16 +27,16 @@ Class
 Description
     Injection at specified positions, with the conditions:
 
-    \li for injection to be allowed
-        \verbatim
-        factor*referenceField[celli] >= thresholdField[celli]
-        \endverbatim
-        where:
+    For injection to be allowed
+      \verbatim
+      factor*referenceField[celli] >= thresholdField[celli]
+      \endverbatim
+      where:
         - \c referenceField is the field used to supply the look-up values
         - \c thresholdField supplies the values beyond which the injection is
             permitted.
 
-    \li limited to a user-supllied number of injections per injector location
+    Limited to a user-supplied number of injections per injector location
 
 SourceFiles
     FieldActivatedInjection.C
diff --git a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/ManualInjection/ManualInjection.H b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/ManualInjection/ManualInjection.H
index b3e78f8c456861003f3b1aa83188df4534cf0c7e..01ecf0d5c6a2ffd8799f6ae5a89bdf94dd5f9ea6 100644
--- a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/ManualInjection/ManualInjection.H
+++ b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/ManualInjection/ManualInjection.H
@@ -27,14 +27,14 @@ Class
 Description
     Manual injection.
 
-    \li User specifies:
-        - Total mass to inject
-        - Parcel positions in file \c positionsFile
-        - Initial parcel velocity
-
-    \li Parcel diameters obtained by distribution model
-
-    \li All parcels introduced at SOI
+    User specifies:
+      - Total mass to inject
+      - Parcel positions in file \c positionsFile
+      - Initial parcel velocity
+
+    Properties:
+      - Parcel diameters obtained by distribution model
+      - All parcels introduced at SOI
 
 SourceFiles
     ManualInjection.C
diff --git a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/PatchFlowRateInjection/PatchFlowRateInjection.H b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/PatchFlowRateInjection/PatchFlowRateInjection.H
index d4c3ee15219196e5e0b8bc2eeeee34dea7730894..df767d2fd66f344b0b1d69e2361dae4cff32515d 100644
--- a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/PatchFlowRateInjection/PatchFlowRateInjection.H
+++ b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/PatchFlowRateInjection/PatchFlowRateInjection.H
@@ -28,14 +28,16 @@ Description
     Patch injection, by using patch flow rate to determine concentration and
     velocity.
 
-    \li User specifies
-        - Total mass to inject
-        - Name of patch
-        - Injection duration
-        - Injection target concentration/carrier volume flow rate
-    \li Initial parcel velocity given by local flow velocity
-    \li Parcel diameters obtained by distribution model
-    \li Parcels injected randomly across the patch
+    User specifies:
+      - Total mass to inject
+      - Name of patch
+      - Injection duration
+      - Injection target concentration/carrier volume flow rate
+
+    Properties:
+      - Initial parcel velocity given by local flow velocity
+      - Parcel diameters obtained by distribution model
+      - Parcels injected randomly across the patch
 
 SourceFiles
     PatchFlowRateInjection.C
diff --git a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/PatchInjection/PatchInjection.H b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/PatchInjection/PatchInjection.H
index 7c02e416387668a233388600595df1e2a07bacc0..b1c0825ecf833af6a5a45992543f3e6847c48370 100644
--- a/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/PatchInjection/PatchInjection.H
+++ b/src/lagrangian/intermediate/submodels/Kinematic/InjectionModel/PatchInjection/PatchInjection.H
@@ -27,14 +27,16 @@ Class
 Description
     Patch injection.
 
-    \li User specifies:
-        - Total mass to inject
-        - Name of patch
-        - Injection duration
-        - Initial parcel velocity
-        - Injection volume flow rate
-    \li Parcel diameters obtained by distribution model
-    \li Parcels injected randomly across the patch
+    User specifies:
+      - Total mass to inject
+      - Name of patch
+      - Injection duration
+      - Initial parcel velocity
+      - Injection volume flow rate
+
+    Properties:
+      - Parcel diameters obtained by distribution model
+      - Parcels injected randomly across the patch
 
 SourceFiles
     PatchInjection.C
diff --git a/src/lagrangian/intermediate/submodels/Kinematic/PatchInteractionModel/StandardWallInteraction/StandardWallInteraction.H b/src/lagrangian/intermediate/submodels/Kinematic/PatchInteractionModel/StandardWallInteraction/StandardWallInteraction.H
index a5abf354a660868c21a74fec4dedda62895d290d..b2aeb491c8d245ede0c8a27bbe7e7579a97da3a8 100644
--- a/src/lagrangian/intermediate/submodels/Kinematic/PatchInteractionModel/StandardWallInteraction/StandardWallInteraction.H
+++ b/src/lagrangian/intermediate/submodels/Kinematic/PatchInteractionModel/StandardWallInteraction/StandardWallInteraction.H
@@ -25,11 +25,12 @@ Class
     Foam::StandardWallInteraction
 
 Description
-    Wall interaction model. Three choices:
+    Wall interaction model.
 
-    \li \c rebound - optionally specify elasticity and restitution coefficients
-    \li \c stick   - particles assigned zero velocity
-    \li \c escape  - remove particle from the domain
+    Three choices:
+      - rebound - optionally specify elasticity and restitution coefficients
+      - stick   - particles assigned zero velocity
+      - escape  - remove particle from the domain
 
     Example usage:
     \verbatim
diff --git a/src/meshTools/coordinateSystems/coordinateRotation/coordinateRotation.H b/src/meshTools/coordinateSystems/coordinateRotation/coordinateRotation.H
index cfee8caf4a581cf2bd31ff0c3e1d29e0e4e78436..085fff4f324e294d33f9c79f665111cf2eaba2e5 100644
--- a/src/meshTools/coordinateSystems/coordinateRotation/coordinateRotation.H
+++ b/src/meshTools/coordinateSystems/coordinateRotation/coordinateRotation.H
@@ -37,11 +37,10 @@ Description
     \endverbatim
 
     Types of coordinateRotation:
-
-    \li 1. axesRotation
-    \li 2. STARCDRotation
-    \li 3. cylindrical
-    \li 4. EulerCoordinateRotation
+      -# axesRotation
+      -# STARCDRotation
+      -# cylindrical
+      -# EulerCoordinateRotation
 
 SourceFiles
     coordinateRotation.C
diff --git a/src/meshTools/coordinateSystems/coordinateRotation/cylindrical.H b/src/meshTools/coordinateSystems/coordinateRotation/cylindrical.H
index 0a846ad001971e66f894c8a4be78769b88cf0037..60e837006da4c474e20d23c0181f884f9f3897ec 100644
--- a/src/meshTools/coordinateSystems/coordinateRotation/cylindrical.H
+++ b/src/meshTools/coordinateSystems/coordinateRotation/cylindrical.H
@@ -26,21 +26,21 @@ Class
 
 Description
     A local coordinate rotation.
-    The cell based rotational field can be created in two ways:
-
-    \li 1. Each rotational tensor is defined with two vectors (\c dir and \c e3)
-        where <tt>dir =  cellC - origin</tt> and \c e3 is the rotation axis.
-        Per each cell an axesRotation type of rotation is created
-        (cylindrical coordinates). For example:
-        \verbatim
-        cylindrical
-        {
-            type        localAxes;
-            e3          (0 0 1);
-        }
-        \endverbatim
 
-    \li 2. The rotational tensor field is provided at construction.
+    The cell based rotational field can be created in two ways:
+      -# Each rotational tensor is defined with two vectors (\c dir and \c e3)
+         where <tt>dir =  cellC - origin</tt> and \c e3 is the rotation axis.
+          Per each cell an axesRotation type of rotation is created
+          (cylindrical coordinates). For example:
+          \verbatim
+          cylindrical
+          {
+              type        localAxes;
+              e3          (0 0 1);
+          }
+          \endverbatim
+
+      -# The rotational tensor field is provided at construction.
 
 SourceFiles
     cylindrical.C
diff --git a/src/meshTools/coordinateSystems/coordinateSystem.H b/src/meshTools/coordinateSystems/coordinateSystem.H
index be719150b7d1c70db04925295da3dd0ce02ecd0b..bc1d9003cc1d41c92f69eef20ecd182de4dbe0bd 100644
--- a/src/meshTools/coordinateSystems/coordinateSystem.H
+++ b/src/meshTools/coordinateSystems/coordinateSystem.H
@@ -43,15 +43,13 @@ Description
     \endverbatim
 
     Types of coordinateRotation:
-
-    \li 1. axesRotation
-    \li 2. STARCDRotation
-    \li 3. cylindrical
-    \li 4. EulerCoordinateRotation
+      -# axesRotation
+      -# \link STARCDCoordinateRotation STARCDRotation \endlink
+      -# cylindricalCS cylindrical
+      -# EulerCoordinateRotation
 
     Type of co-ordinates:
-
-    \li 1. cartesian
+      -# \link cartesianCS cartesian \endlink
 
 
 SourceFiles
diff --git a/src/meshTools/triSurface/surfaceLocation/surfaceLocation.H b/src/meshTools/triSurface/surfaceLocation/surfaceLocation.H
index 7bc2263f6b46015745ea504501395700a69b1d4d..e0c7dc45495c9384c0ec2756aeb1ea973b393aa6 100644
--- a/src/meshTools/triSurface/surfaceLocation/surfaceLocation.H
+++ b/src/meshTools/triSurface/surfaceLocation/surfaceLocation.H
@@ -25,20 +25,18 @@ Class
     Foam::surfaceLocation
 
 Description
-    Contains information about location on a triSurface:
+    Contains information about location on a triSurface
 
-    \li pointIndexHit:
+    Access to data:
+      - pointIndexHit provides
         - location
         - bool: hit/miss
         - index (of triangle/point/edge)
-
-    \li elementType():
+      - elementType() provides
         - what index above relates to. In triangle::proxType
-
-    \li triangle():
+      - triangle() provides
         - last known triangle
 
-
 SourceFiles
     surfaceLocation.C
 
diff --git a/src/parallel/decompose/ptscotchDecomp/ptscotchDecomp.H b/src/parallel/decompose/ptscotchDecomp/ptscotchDecomp.H
index 5cb64e4be6de35f31437472f02bc5594e8664a2f..1465ff2daabd4518a6b1785decb3cf8552fb3780 100644
--- a/src/parallel/decompose/ptscotchDecomp/ptscotchDecomp.H
+++ b/src/parallel/decompose/ptscotchDecomp/ptscotchDecomp.H
@@ -37,9 +37,8 @@ Description
     \endverbatim
 
     where:
-
-    \li \c %r gets replaced by current processor rank
-    \li it will decompose into 2 domains
+      - %r gets replaced by current processor rank
+      - it will decompose into 2 domains
 
 SeeAlso
     Foam::scotchDecomp
diff --git a/src/regionModels/regionCoupling/derivedFvPatchFields/filmPyrolysisRadiativeCoupledMixed/filmPyrolysisRadiativeCoupledMixedFvPatchScalarField.H b/src/regionModels/regionCoupling/derivedFvPatchFields/filmPyrolysisRadiativeCoupledMixed/filmPyrolysisRadiativeCoupledMixedFvPatchScalarField.H
index 16f7e9ff6baa6dbb0ebb165df86481fe5f436f9d..9e1ed0f978d868432866bbafe162f23ca80a4172 100644
--- a/src/regionModels/regionCoupling/derivedFvPatchFields/filmPyrolysisRadiativeCoupledMixed/filmPyrolysisRadiativeCoupledMixedFvPatchScalarField.H
+++ b/src/regionModels/regionCoupling/derivedFvPatchFields/filmPyrolysisRadiativeCoupledMixed/filmPyrolysisRadiativeCoupledMixedFvPatchScalarField.H
@@ -66,8 +66,8 @@ Description
 
     Notes:
 
-    \li \c kappa and \c kappaName are inherited from temperatureCoupledBase.
-    \li \c Qr is the radiative flux defined in the radiation model.
+    - kappa and \c kappaName are inherited from temperatureCoupledBase.
+    - Qr is the radiative flux defined in the radiation model.
 
 
 SeeAlso
diff --git a/src/regionModels/regionCoupling/derivedFvPatchFields/filmPyrolysisTemperatureCoupled/filmPyrolysisTemperatureCoupledFvPatchScalarField.H b/src/regionModels/regionCoupling/derivedFvPatchFields/filmPyrolysisTemperatureCoupled/filmPyrolysisTemperatureCoupledFvPatchScalarField.H
index 84c7932d72f388c796e0434cf19fe34b90781461..2e068ccf4e9cd217932517e051877782bf0b72fa 100644
--- a/src/regionModels/regionCoupling/derivedFvPatchFields/filmPyrolysisTemperatureCoupled/filmPyrolysisTemperatureCoupledFvPatchScalarField.H
+++ b/src/regionModels/regionCoupling/derivedFvPatchFields/filmPyrolysisTemperatureCoupled/filmPyrolysisTemperatureCoupledFvPatchScalarField.H
@@ -30,8 +30,8 @@ Description
     for patches on the primary region based on whether the patch is seen to
     be 'wet', retrieved from the film alpha field.
 
-    \li if the patch is wet, the temperature is set using the film temperature
-    \li otherwise, it is set using pyrolysis temperature
+    - if the patch is wet, the temperature is set using the film temperature
+    - otherwise, it is set using pyrolysis temperature
 
     Example of the boundary condition specification:
     \verbatim
diff --git a/src/regionModels/regionCoupling/derivedFvPatchFields/filmPyrolysisVelocityCoupled/filmPyrolysisVelocityCoupledFvPatchVectorField.H b/src/regionModels/regionCoupling/derivedFvPatchFields/filmPyrolysisVelocityCoupled/filmPyrolysisVelocityCoupledFvPatchVectorField.H
index f4566b2325291dd65234618d4407c12e95c7be1a..df19b8fbdd50ebf55565d55d36a19ccedb1f6a62 100644
--- a/src/regionModels/regionCoupling/derivedFvPatchFields/filmPyrolysisVelocityCoupled/filmPyrolysisVelocityCoupledFvPatchVectorField.H
+++ b/src/regionModels/regionCoupling/derivedFvPatchFields/filmPyrolysisVelocityCoupled/filmPyrolysisVelocityCoupledFvPatchVectorField.H
@@ -26,12 +26,13 @@ Class
 
 Description
     This boundary condition is designed to be used in conjunction with surface
-    film and pyrolysis modelling.  It provides a velocity boundary condition
-    for patches on the primary region based on whether the patch is seen to
-    be 'wet', retrieved from the film alpha field.
+    film and pyrolysis modelling.
 
-    \li if the patch is wet, the velocity is set using the film velocity
-    \li otherwise, it is set using pyrolysis out-gassing velocity
+    It provides a velocity boundary condition for patches on the primary region
+    based on whether the patch is seen to be 'wet', retrieved from the film
+    alpha field.
+      - if the patch is wet, the velocity is set using the film velocity
+      - otherwise, it is set using pyrolysis out-gassing velocity
 
     Example of the boundary condition specification:
     \verbatim
diff --git a/src/regionModels/thermalBaffleModels/derivedFvPatchFields/thermalBaffle/thermalBaffleFvPatchScalarField.H b/src/regionModels/thermalBaffleModels/derivedFvPatchFields/thermalBaffle/thermalBaffleFvPatchScalarField.H
index 389672e74fc1bcd23b2c353d06b4eeeba735a315..d5f15aa003d949ba501171a33b2f7cb2ebba1b2e 100644
--- a/src/regionModels/thermalBaffleModels/derivedFvPatchFields/thermalBaffle/thermalBaffleFvPatchScalarField.H
+++ b/src/regionModels/thermalBaffleModels/derivedFvPatchFields/thermalBaffle/thermalBaffleFvPatchScalarField.H
@@ -29,16 +29,16 @@ Group
 
 Description
     This boundary condition provides a coupled temperature condition between
-    multiple mesh regions.  The regions are generally referred to as the:
+    multiple mesh regions.
 
-    \li primary region,
-    \li and baffle region.
+    The regions are generally referred to as the:
+      - primary region,
+      - and baffle region.
 
     The primary region creates the baffle region and evolves its energy
     equation either:
-
-    - 1-D, normal to each patch face
-    - 2-D, normal and tangential components
+      - 1-D, normal to each patch face
+      - 2-D, normal and tangential components
 
     The thermodynamic properties of the baffle material are specified via
     dictionary entries on the master patch.
@@ -118,7 +118,7 @@ Description
     }
     \endverbatim
 
-    \li Slave patch on primary region
+    Slave patch on primary region:
     \verbatim
     myPatch_slave
     {
@@ -129,7 +129,7 @@ Description
     \endverbatim
 
 
-    \li Patches on baffle region
+    Patches on baffle region:
     \verbatim
     bottom
     {
diff --git a/src/transportModels/twoPhaseProperties/alphaContactAngle/alphaContactAngle/alphaContactAngleFvPatchScalarField.H b/src/transportModels/twoPhaseProperties/alphaContactAngle/alphaContactAngle/alphaContactAngleFvPatchScalarField.H
index 550868bf4573b30203ca1ae3076ada2d1b50c24c..d1af35cd78d47ce5316600e6fdfa6c0553f858ea 100644
--- a/src/transportModels/twoPhaseProperties/alphaContactAngle/alphaContactAngle/alphaContactAngleFvPatchScalarField.H
+++ b/src/transportModels/twoPhaseProperties/alphaContactAngle/alphaContactAngle/alphaContactAngleFvPatchScalarField.H
@@ -34,12 +34,11 @@ Description
     wall contact angle field.
 
     The essential entry "limit" controls the gradient of alpha1 on the wall:
-
-    \li \c none - Calculate the gradient from the contact-angle without limiter
-    \li \c gradient - Limit the wall-gradient such that alpha1 remains bounded
+      - none - Calculate the gradient from the contact-angle without limiter
+      - gradient - Limit the wall-gradient such that alpha1 remains bounded
         on the wall
-    \li \c alpha - Bound the calculated alpha1 on the wall
-    \li \c zeroGradient - Set the gradient of alpha1 to 0 on the wall, i.e.
+      - alpha - Bound the calculated alpha1 on the wall
+      - zeroGradient - Set the gradient of alpha1 to 0 on the wall, i.e.
         reproduce previous behaviour, the pressure BCs can be left as before.
 
     Note that if any of the first three options are used the boundary condition