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

- mapFields and splitMeshRegions need more clarification

applications/utilities/mesh/manipulation/createBaffles/createBaffles.C

@@ -124,18 +124,35 @@ label findPatchID(const polyMesh& mesh, const word& name)
 
 int main(int argc, char *argv[])
 {
-#   include "addOverwriteOption.H"
-#   include "addRegionOption.H"
+    argList::addNote
+    (
+        "Makes internal faces into boundary faces.\n"
+        "Does not duplicate points, unlike mergeOrSplitBaffles."
+    );
+
+    #include "addOverwriteOption.H"
+    #include "addRegionOption.H"
 
     argList::validArgs.append("faceZone");
     argList::validArgs.append("patch");
-    argList::addOption("additionalPatches", "(patch2 .. patchN)");
-    argList::addBoolOption("internalFacesOnly");
 
-#   include "setRootCase.H"
-#   include "createTime.H"
+    argList::addOption
+    (
+        "additionalPatches",
+        "(patch2 .. patchN)",
+        "specify additional patches for creating baffles"
+    );
+    argList::addBoolOption
+    (
+        "internalFacesOnly",
+        "do not convert boundary faces"
+    );
+
+    #include "setRootCase.H"
+    #include "createTime.H"
     runTime.functionObjects().off();
-#   include "createNamedMesh.H"
+    #include "createNamedMesh.H"
+
     const word oldInstance = mesh.pointsInstance();
 
     const polyBoundaryMesh& patches = mesh.boundaryMesh();