STYLE: add notes to some (most) command-line options

- mapFields and splitMeshRegions need more clarification

applications/utilities/mesh/advanced/combinePatchFaces/combinePatchFaces.C

@@ -38,7 +38,7 @@ Description
 
     E.g. to allow all faces on same patch to be merged:
 
-        combinePatchFaces .. cavity 180 -concaveAngle 90
+        combinePatchFaces 180 -concaveAngle 90
 
 \*---------------------------------------------------------------------------*/
 
@@ -429,15 +429,18 @@ int main(int argc, char *argv[])
 {
 #   include "addOverwriteOption.H"
 
-    argList::validArgs.append("feature angle [0..180]");
+    argList::validArgs.append("featureAngle [0..180]");
     argList::addOption
     (
         "concaveAngle",
-        "[0..180]",
-        "specify concave angle [0..180] degrees (default: 30.0 degrees)"
+        "degrees",
+        "specify concave angle [0..180] (default: 30 degrees)"
+    );
+    argList::addBoolOption
+    (
+        "snapMesh",
+        "use system/snapMeshDict"
     );
-
-    argList::addBoolOption("snapMesh");
 
 #   include "setRootCase.H"
 #   include "createTime.H"

applications/utilities/mesh/advanced/refineWallLayer/refineWallLayer.C

@@ -46,12 +46,18 @@ using namespace Foam;
 
 int main(int argc, char *argv[])
 {
-#   include "addOverwriteOption.H"
+    #include "addOverwriteOption.H"
     argList::noParallel();
     argList::validArgs.append("patchName");
     argList::validArgs.append("edgeWeight");
 
-    argList::addOption("useSet", "cellSet");
+    argList::addOption
+    (
+        "useSet",
+        "name",
+        "restrict cells to refine based on specified cellSet name"
+    );
+
 
 #   include "setRootCase.H"
 #   include "createTime.H"

applications/utilities/mesh/advanced/refinementLevel/refinementLevel.C

@@ -96,11 +96,15 @@ bool limitRefinementLevel
 
 int main(int argc, char *argv[])
 {
-    argList::addBoolOption("readLevel");
+    argList::addBoolOption
+    (
+        "readLevel",
+        "read level from refinementLevel file"
+    );
 
-#   include "setRootCase.H"
-#   include "createTime.H"
-#   include "createPolyMesh.H"
+    #include "setRootCase.H"
+    #include "createTime.H"
+    #include "createPolyMesh.H"
 
     Info<< "Dividing cells into bins depending on cell volume.\nThis will"
         << " correspond to refinement levels for a mesh with only 2x2x2"
@@ -109,7 +113,7 @@ int main(int argc, char *argv[])
         << " to allow for some truncation error."
         << nl << endl;
 
-    bool readLevel = args.optionFound("readLevel");
+    const bool readLevel = args.optionFound("readLevel");
 
     const scalarField& vols = mesh.cellVolumes();
 

applications/utilities/mesh/advanced/splitCells/splitCells.C

@@ -517,17 +517,35 @@ void collectCuts
 
 int main(int argc, char *argv[])
 {
-#   include "addOverwriteOption.H"
+    argList::addNote
+    (
+        "split cells with flat faces"
+    );
+    #include "addOverwriteOption.H"
     argList::noParallel();
-    argList::addOption("set", "cellSet name");
-    argList::addBoolOption("geometry");
-    argList::addOption("tol", "edge snap tolerance");
-    argList::validArgs.append("edge angle [0..360]");
+    argList::validArgs.append("edgeAngle [0..360]");
 
-#   include "setRootCase.H"
-#   include "createTime.H"
+    argList::addOption
+    (
+        "set",
+        "name",
+        "split cells from specified cellSet only"
+    );
+    argList::addBoolOption
+    (
+        "geometry",
+        "use geometric cut for hexes as well"
+    );
+    argList::addOption
+    (
+        "tol",
+        "scalar", "edge snap tolerance (default 0.2)"
+    );
+
+    #include "setRootCase.H"
+    #include "createTime.H"
     runTime.functionObjects().off();
-#   include "createPolyMesh.H"
+    #include "createPolyMesh.H"
     const word oldInstance = mesh.pointsInstance();
 
     const scalar featureAngle = args.argRead<scalar>(1);
@@ -538,7 +556,7 @@ int main(int argc, char *argv[])
     const bool geometry  = args.optionFound("geometry");
     const bool overwrite = args.optionFound("overwrite");
 
-    scalar edgeTol = args.optionLookupOrDefault("tol", 0.2);
+    const scalar edgeTol = args.optionLookupOrDefault("tol", 0.2);
 
     Info<< "Trying to split cells with internal angles > feature angle\n" << nl
         << "featureAngle      : " << featureAngle << nl