STYLE: adjusted wording and messages for wmake

- add an additional test for wmake pre-processing

applications/test/wmake1/Make/files

+Test-wmake1.C
+
+/* #if OPENFOAM == 1812 */
+#if OPENFOAM > 1812
+newStub.C
+#else
+oldStub.C
+#endif
+
+EXE = $(FOAM_APPBIN)/Test-wmake1

applications/test/wmake1/Make/options

+EXE_INC =
+EXE_LIBS =

applications/test/wmake1/Test-wmake1.C

+/*---------------------------------------------------------------------------*\
+  =========                 |
+  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
+   \\    /   O peration     |
+    \\  /    A nd           | Copyright (C) 2019 OpenCFD Ltd.
+     \\/     M anipulation  |
+-------------------------------------------------------------------------------
+License
+    This file is part of OpenFOAM.
+
+    OpenFOAM is free software: you can redistribute it and/or modify it
+    under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
+    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+    FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+    for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
+
+Application
+    Test-wmake1
+
+Description
+    Some tests for wmake features.
+    For example, testing how robust or fragile version-dependent conditional
+    compilation works.
+
+\*---------------------------------------------------------------------------*/
+
+#include "argList.H"
+
+namespace Foam
+{
+    void printTest();
+}
+
+
+using namespace Foam;
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+int main(int argc, char *argv[])
+{
+    printTest();
+
+    Info<< "\nEnd\n" << nl;
+
+    return 0;
+}
+
+
+// ************************************************************************* //

applications/test/wmake1/newStub.C

+// Some test code
+
+#include "foamVersion.H"
+#include "IOstreams.H"
+
+namespace Foam
+{
+    void printTest()
+    {
+        Info<< nl;
+        foamVersion::printBuildInfo();
+    }
+}

applications/test/wmake1/oldStub.C

+// Some test code
+
+#include "IOstreams.H"
+
+namespace Foam
+{
+    void printTest()
+    {
+        Info<< nl << "Using old stub" << nl;
+
+        #if OPENFOAM
+        Info<< "OPENFOAM=" << OPENFOAM << nl;
+        #else
+        Info<< "OPENFOAM is undefined" << nl;
+        #endif
+    }
+}

wmake/makefiles/general

@@ -175,7 +175,7 @@ lib: $(LIB).a | silent
 $(LIB).a: $(OBJECTS)
 	@$(WM_SCRIPTS)/makeTargetDir $(LIB)
 	@rm -f $(LIB).a
-	$(call QUIET_MESSAGE,ar,$(LIB))
+	$(call QUIET_MESSAGE,ar,$(LIB).a)
 	$E $(AR) $(ARFLAGS) $(LIB).a $(OBJECTS)
 	$(call QUIET_MESSAGE,ranlib,$(notdir $(LIB)))
 	$E $(RANLIB) $(LIB).a

wmake/makefiles/info

@@ -43,16 +43,13 @@ include $(GENERAL_RULES)/general
 # Display information
 #------------------------------------------------------------------------------
 
-export WM_VERSION
-
-
 .PHONY: compile
 compile:
 	@echo "$(strip $(CC) $(c++FLAGS))"
 
 .PHONY: api
 api:
-	@echo "$${WM_VERSION#*=}"
+	@echo "$(WM_VERSION)" | sed -e 's/^.*=//'
 
 .PHONY: c
 c:

wmake/wmake

@@ -70,18 +70,16 @@ options:
   -s | -silent      Quiet mode (does not echo commands)
   -a | -all         wmake all sub-directories, running Allwmake if present
   -q | -queue       wmakeCollect all sub-directories, running Allwmake if present
-  -k | -keep-going  Keep going without stopping when errors occur (-non-stop)
+  -k | -keep-going  Keep going even when errors occur (-non-stop)
   -j                Compile using all local cores/hyperthreads
-  -jN or -j N       Compile using N cores/hyperthreads
+  -jN | -j N        Compile using N cores/hyperthreads
   -no-scheduler     Disable scheduled parallel compilation
-  -pwd              Print root directory containing a Make/ directory and exit
-  -update           Update lnInclude directories, dep files, remove deprecated
-                    files and directories
-  -show             Identical to -show-compile
-  -show-api         Print api value and exit
-  -show-compile     Print C++ compiler value/flags and exit
-  -show-cxx         Print C++ compiler value and exit
-  -show-cxxflags    Print C++ compiler flags and exit
+  -pwd              Print root directory containing a Make/ directory
+  -update           Update lnInclude dirs, dep files, remove deprecated files/dirs
+  -show-api         Print api value
+  -show-compile     Print C++ compiler value and flags (shortcut: -show)
+  -show-cxx         Print C++ compiler value
+  -show-cxxflags    Print C++ compiler flags
   -h | -help        Print the usage