Deprecate gmake action, add onDeprecate hook to actions

Author: nickclark2016

modules/gmake/_preload.lua

@@ -24,6 +24,10 @@
 			dotnet = { "mono", "msnet", "pnet" }
 		},
 
+		onDeprecate = function()
+			p.warnOnce("gmake-deprecate", "The gmake action has been deprecated in favor of gmake2. Please update your scripts to use the new action.")
+		end,
+
 		onWorkspace = function(wks)
 			p.escaper(p.make.esc)
 			wks.projects = table.filter(wks.projects, function(prj) return p.action.supports(prj.kind) and prj.kind ~= p.NONE end)

src/base/action.lua

@@ -98,6 +98,12 @@
 	function action.call(name)
 		local a = action._list[name]
 
+		if a.onDeprecate then
+			term.pushColor(term.yellow)
+			a.onDeprecate()
+			term.popColor()
+		end
+
 		if a.onStart then
 			a.onStart()
 		end

website/docs/Building-Premake.md

@@ -36,7 +36,7 @@ On other platforms, if the bootstrap fails to build, you will need to have a wor
 Once you have a working Premake available, you can generate the project files for your toolset by running a command like the following in the top-level Premake directory:
 
 ```bash
-premake5 gmake  # for makefiles
+premake5 gmake2 # for makefiles
 premake5 vs2012 # for a Visual Studio 2012 solution
 premake --help  # to see a list of supported toolsets
 ```

website/docs/Your-First-Script.md

@@ -48,7 +48,7 @@ This particular command will generate `HelloWorld.sln` and `HelloWorld.vcxproj`
 If you happened to be on Linux, you could generate and build a makefile like so:
 
 ```bash
-$ premake5 gmake
+$ premake5 gmake2
 $ make                # build default (Debug) configuration
 $ make config=release # build release configuration
 $ make help           # show available configurations

website/docs/buildoptions.md

@@ -23,6 +23,6 @@ Premake 4.0 or later.
 Use `pkg-config` style configuration when building on Linux with GCC. Build options are always compiler specific and should be targeted to a particular toolset.
 
 ```lua
-filter { "system:linux", "action:gmake" }
+filter { "system:linux", "action:gmake*" }
   buildoptions { "`wx-config --cxxflags`", "-ansi", "-pedantic" }
 ```

website/docs/configuration.md

@@ -16,7 +16,7 @@ The available sources for keywords. Keywords are not case-sensitive.
 
 * **Configuration names.** Any of the configuration names supplied to the **[configurations](configurations.md)** or **[platforms](platforms.md)** functions.
 
-* **Action names** such as **vs2010** or **gmake**. See the [Using Premake](Using-Premake.md) for a complete list.
+* **Action names** such as **vs2010** or **gmake2**. See the [Using Premake](Using-Premake.md) for a complete list.
 
 * **Command line options**.
 

website/docs/globals/premake_OS.md

@@ -11,7 +11,7 @@ Stores the name of the operating system currently being targeted; see [system()]
 The current OS may be overridden on the command line with the `--os` option.
 
 ```
-$ premake5 --os=linux gmake
+$ premake5 --os=linux gmake2
 ```
 
 ### Availability ###

website/docs/globals/premake_TARGET_ARCH.md

@@ -7,7 +7,7 @@ Stores the name of the architecture currently being targeted; see [architecture(
 The current architecture may be overridden on the command line with the `--arch` option.
 
 ```
-$ premake5 --arch=x86 gmake
+$ premake5 --arch=x86 gmake2
 ```
 
 ### Availability ###

website/docs/globals/premake_TARGET_OS.md

@@ -7,7 +7,7 @@ Stores the name of the operating system currently being targeted; see [system()]
 The current OS may be overridden on the command line with the `--os` option.
 
 ```
-$ premake5 --os=linux gmake
+$ premake5 --os=linux gmake2
 ```
 
 ### Availability ###

website/docs/linkgroups.md

@@ -1,4 +1,4 @@
-Turns on/off linkgroups for gcc/clang in the gmake backend.
+Turns on/off linkgroups for gcc/clang in the gmake and gmake2 backend.
 
 ```lua
 linkgroups ("value")