add some usage information to a few utilities

applications/solvers/lagrangian/uncoupledKinematicParcelFoam/createFields.H

@@ -47,8 +47,10 @@
         )
     );
 
-    word kinematicCloudName("kinematicCloud");
+    const word kinematicCloudName
-    args.optionReadIfPresent("cloudName", kinematicCloudName);
+    (
+        args.optionLookupOrDefault<word>("cloudName", "kinematicCloud")
+    );
 
     Info<< "Constructing kinematicCloud " << kinematicCloudName << endl;
     basicKinematicCloud kinematicCloud

applications/utilities/mesh/conversion/foamToStarMesh/foamToStarMesh.C

@@ -76,10 +76,27 @@ int main(int argc, char *argv[])
     argList::noParallel();
     timeSelector::addOptions();
 
-    argList::addOption("scale", "scale");
+    argList::addOption
-    argList::addBoolOption("noBnd");
+    (
-    argList::addBoolOption("tri");
+        "scale",
-    argList::addBoolOption("surface");
+        "factor",
+        "specify geometry scaling factor - default is 1000 ([m] to [mm])"
+    );
+    argList::addBoolOption
+    (
+        "noBnd",
+        "suppress writing the .bnd file"
+    );
+    argList::addBoolOption
+    (
+        "tri",
+        "Extract a triangulated surface. Implies -surface"
+    );
+    argList::addBoolOption
+    (
+        "surface",
+        "extract the surface of the volume mesh only"
+    );
 
 #   include "setRootCase.H"
 #   include "createTime.H"

applications/utilities/mesh/conversion/star4ToFoam/star4ToFoam.C

@@ -62,9 +62,22 @@ int main(int argc, char *argv[])
 {
     argList::noParallel();
     argList::validArgs.append("pro-STAR prefix");
-    argList::addBoolOption("ascii");
+    argList::addBoolOption
-    argList::addOption("scale", "scale");
+    (
-    argList::addBoolOption("solids");
+        "ascii",
+        "write in ASCII instead of binary format"
+    );
+    argList::addOption
+    (
+        "scale",
+        "scale",
+        "geometry scaling factor - default is 0.001 ([mm] to [m])"
+    );
+    argList::addBoolOption
+    (
+        "solids",
+        "retain solid cells and treat them like fluid cells"
+    );
 
     argList args(argc, argv);
     Time runTime(args.rootPath(), args.caseName());

applications/utilities/mesh/generation/blockMesh/blockMeshApp.C

@@ -72,8 +72,18 @@ using namespace Foam;
 int main(int argc, char *argv[])
 {
     argList::noParallel();
-    argList::addBoolOption("blockTopology");
+    argList::addBoolOption
-    argList::addOption("dict", "dictionary");
+    (
+        "blockTopology",
+        "write block edges and centres as .obj files"
+    );
+    argList::addOption
+    (
+        "dict",
+        "NAME",
+        "specify an alternative dictionary for the blockMesh description"
+    );
+
 #   include "addRegionOption.H"
 #   include "setRootCase.H"
 #   include "createTime.H"

applications/utilities/parallelProcessing/decomposePar/decomposePar.C

@@ -88,20 +88,39 @@ int main(int argc, char *argv[])
     argList::noParallel();
 #   include "addRegionOption.H"
     argList::addBoolOption("cellDist");
-    argList::addBoolOption("copyUniform");
+    argList::addBoolOption
-    argList::addBoolOption("fields");
+    (
-    argList::addBoolOption("filterPatches");
+        "copyUniform",
-    argList::addBoolOption("force");
+        "copy any uniform/ directories too"
-    argList::addBoolOption("ifRequired");
+    );
+    argList::addBoolOption
+    (
+        "fields",
+        "use existing geometry decomposition and convert fields only"
+    );
+    argList::addBoolOption
+    (
+        "filterPatches",
+        "remove empty patches when decomposing the geometry"
+    );
+    argList::addBoolOption
+    (
+        "force",
+        "remove existing processor*/ subdirs before decomposing the geometry"
+    );
+    argList::addBoolOption
+    (
+        "ifRequired",
+        "only decompose geometry if the number of domains has changed"
+    );
 
 #   include "setRootCase.H"
 
     word regionName = fvMesh::defaultRegion;
     word regionDir = word::null;
 
-    if (args.optionFound("region"))
+    if (args.optionReadIfPresent("region", regionName))
     {
-        regionName = args.option("region");
         regionDir = regionName;
         Info<< "Decomposing mesh " << regionName << nl << endl;
     }
@@ -124,10 +143,10 @@ int main(int argc, char *argv[])
         isDir
         (
             runTime.path()
-           /(word("processor") + name(nProcs))
+          / (word("processor") + name(nProcs))
-           /runTime.constant()
+          / runTime.constant()
-           /regionDir
+          / regionDir
-           /polyMesh::meshSubDir
+          / polyMesh::meshSubDir
         )
     )
     {

applications/utilities/postProcessing/dataConversion/foamToEnsight/foamToEnsight.C

@@ -93,10 +93,23 @@ bool inFileNameList
 
 int main(int argc, char *argv[])
 {
-    argList::addBoolOption("ascii");
+    argList::addBoolOption
-    argList::addBoolOption("noPatches");
+    (
-
+        "ascii",
-    argList::addOption("patches", "patchList");
+        "write in ASCII format instead of 'C Binary'"
+    );
+    argList::addBoolOption
+    (
+        "noPatches",
+        "Suppress writing any patches"
+    );
+    argList::addOption
+    (
+        "patches",
+        "patchList",
+        "Specify particular patches to write. "
+        "An empty list suppresses writing the internalMesh."
+    );
 
 #   include "addTimeOptions.H"
 #   include "setRootCase.H"

applications/utilities/postProcessing/dataConversion/foamToEnsightParts/foamToEnsightParts.C

@@ -79,9 +79,24 @@ int main(int argc, char *argv[])
     // afterwards anyhow
     timeSelector::addOptions(true, false);
     argList::noParallel();
-    argList::addBoolOption("ascii");
+    argList::addBoolOption
-    argList::addOption("index",  "start");
+    (
-    argList::addBoolOption("noMesh");
+        "ascii",
+        "write in ASCII format instead of 'C Binary'"
+    );
+    argList::addOption
+    (
+        "index",
+        "start",
+        "ignore the time index contained in the uniform/time file "
+        "and use a simple indexing when creating the files"
+    );
+    argList::addBoolOption
+    (
+        "noMesh",
+        "Suppress writing the geometry. "
+        "Can be useful for converting partial results for a static geometry."
+    );
 
     // the volume field types that we handle
     wordHashSet volFieldTypes;