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/postProcessing/lumped/lumpedPointMovement/lumpedPointMovement.C

@@ -119,9 +119,8 @@ int main(int argc, char *argv[])
         "len",
         "Visualization length for planes (visualized as triangles)"
     );
-    argList::addBoolOption
+    argList::addDryRunOption
     (
-        "dry-run",
         "Test movement without a mesh"
     );
     argList::addBoolOption
@@ -142,7 +141,7 @@ int main(int argc, char *argv[])
     const label span   = Foam::max(1, args.getOrDefault<label>("span", 1));
 
     // Control parameters
-    const bool dryrun = args.found("dry-run");
+    const bool dryrun = args.dryRun();
     const bool slave = args.found("slave");
     const bool removeLock = args.found("removeLock");
 

applications/utilities/postProcessing/lumped/lumpedPointZones/lumpedPointZones.C

@@ -5,7 +5,7 @@
     \\  /    A nd           | www.openfoam.com
      \\/     M anipulation  |
 -------------------------------------------------------------------------------
-    Copyright (C) 2016-2020 OpenCFD Ltd.
+    Copyright (C) 2016-2021 OpenCFD Ltd.
 -------------------------------------------------------------------------------
 License
     This file is part of OpenFOAM.
@@ -55,9 +55,8 @@ int main(int argc, char *argv[])
 
     argList::noFunctionObjects();  // Never use function objects
 
-    argList::addBoolOption
+    argList::addDryRunOption
     (
-        "dry-run",
         "Test initial lumped points state without a mesh"
     );
     argList::addOption
@@ -85,15 +84,13 @@ int main(int argc, char *argv[])
 
     const bool noInterpolate = args.found("no-interpolate");
 
-    const bool dryrun = args.found("dry-run");
-
     // const bool verbose = args.found("verbose");
 
     args.readIfPresent("visual-length", lumpedPointState::visLength);
 
     #include "createTime.H"
 
-    if (dryrun)
+    if (args.dryRun())
     {
         // Create without a mesh
         autoPtr<lumpedPointIOMovement> movement =