ENH: argList improvements

- argList::envExecutable() static method.
  This is identical to getEnv("FOAM_EXECUTABLE"), where the name of
  the executable has typically been set from the argList construction.

  Provides a singleton access to this value from locations that
  do not have knowledge of the originating command args (argList).
  This is a similar rationale as for the argList::envGlobalPath() static.

- additional argList::envRelativePath() static method.

- make -dry-run handling more central and easier to use by adding into
  argList itself.

STYLE: drop handling of -srcDoc (v1706 option)

- replaced with -doc-source for 1712 and never used much anyhow

applications/utilities/preProcessing/PDR/PDRsetFields/PDRsetFields.C

@@ -74,9 +74,8 @@ int main(int argc, char* argv[])
         "Force use of legacy obstacles table"
     );
 
-    argList::addBoolOption
+    argList::addDryRunOption
     (
-        "dry-run",
         "Read obstacles and write VTK only"
     );
 
@@ -90,8 +89,6 @@ int main(int argc, char* argv[])
 
     IOdictionary setFieldsDict(dictIO);
 
-    const bool dryrun = args.found("dry-run");
-
     const fileName& casepath = runTime.globalPath();
 
     pars.timeName = "0";
@@ -181,7 +178,7 @@ int main(int argc, char* argv[])
 
     PDRobstacle::generateVtk(casepath/"VTK", obstacles, cylinders);
 
-    if (dryrun)
+    if (args.dryRun())
     {
         Info<< nl
             << "dry-run: stopping after reading/writing obstacles" << nl

applications/utilities/preProcessing/foamUpgradeCyclics/foamUpgradeCyclics.C

@@ -404,9 +404,8 @@ int main(int argc, char *argv[])
     timeSelector::addOptions();
 
     argList::addOptionCompat("dry-run", {"test", 1806});
-    argList::addBoolOption
+    argList::addDryRunOption
     (
-        "dry-run",
         "Test only do not change any files"
     );
     argList::addBoolOption

applications/utilities/preProcessing/setExprBoundaryFields/setExprBoundaryFields.C

@@ -91,16 +91,15 @@ int main(int argc, char *argv[])
         "Preserve sub-entry as .backup",
         true // Advanced
     );
-    argList::addBoolOption
+    argList::addDryRunOption
     (
-        "dry-run",
         "Evaluate but do not write"
     );
 
     #include "addRegionOption.H"
     #include "setRootCase.H"
 
-    const bool dryrun      = args.found("dry-run");
+    const bool dryrun      = args.dryRun();
     const bool backup      = args.found("backup");
     const bool cacheFields = args.found("cache-fields");
 

applications/utilities/preProcessing/setExprFields/setExprFields.C

@@ -549,9 +549,8 @@ int main(int argc, char *argv[])
         "file",
         "Alternative dictionary for setExprFieldsDict"
     );
-    argList::addBoolOption
+    argList::addDryRunOption
     (
-        "dry-run",
         "Evaluate but do not write"
     );
     argList::addBoolOption
@@ -663,7 +662,7 @@ int main(int argc, char *argv[])
 
     #include "createTime.H"
 
-    const bool dryrun = args.found("dry-run");
+    const bool dryrun = args.dryRun();
     const bool verbose = args.found("verbose");
 
     const word dictName("setExprFieldsDict");