diff options
author | 2015-05-02 19:41:03 +0200 | |
---|---|---|
committer | 2015-05-02 19:41:03 +0200 | |
commit | cc3b682e52bf097d31db78032aad01d6a0b12e94 (patch) | |
tree | 860c97ca011b64c31a5ad277f5cea2b1d86eeaf0 /3rdparty/genie/docs/scripting-reference.md | |
parent | 7df6a23ba2ae1c1df94ed8cc2398f2546f339997 (diff) | |
parent | a649a95488e1fc85813dda747dc74c596496bd1c (diff) |
Merge pull request #1 from mamedev/master
Sync to master
Diffstat (limited to '3rdparty/genie/docs/scripting-reference.md')
-rw-r--r-- | 3rdparty/genie/docs/scripting-reference.md | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/3rdparty/genie/docs/scripting-reference.md b/3rdparty/genie/docs/scripting-reference.md index 02a8fb4b653..85464a74f00 100644 --- a/3rdparty/genie/docs/scripting-reference.md +++ b/3rdparty/genie/docs/scripting-reference.md @@ -15,9 +15,11 @@ * [buildoptions](#buildoptionsoptions) * [configuration](#configurationkeywords) * [configurations](#configurationsnames) + * [custombuildtask](#custombuildtasktask) * [debugargs](#debugargsargs) * [debugdir](#debugdirpath) * [defines](#definessymbols) + * [dependency](#dependencyfiles) * [deploymentoptions](#deploymentoptionsoptions) * [excludes](#excludesfiles) * [files](#filesfiles) @@ -78,6 +80,7 @@ * [pchsource](#pchsourcefile) * [platforms](#platformsidentifiers) * [postbuildcommands](#postbuildcommandscommands) + * [postcompiletasks](#postcompiletaskstasks) * [prebuildcommands](#prebuildcommandscommands) * [prelinkcommands](#prelinkcommandscommands) * [printf](#printfformat-args) @@ -334,6 +337,33 @@ local cfgs = configurations() [Back to top](#table-of-contents) --- +### custombuildtask({_input_file_, _output_file_, {_dependency_,...},{_command_,...}},...) +Defines custom build task for specific input file, that generates output file, there can be additional dependencies, and +for rule listed commands are executed. + +**Scope:** solutions, projects, configurations + +#### Arguments +_input_file_ - source file that should be "compiled" with custom task +_output_file_ - generated file name +_dependency_ - additional dependencies, that can be used as parameters to commands +_command_ - command list, special functions in commands are : + $(<) - input file + $(@) - output file + $(1) - $(9) - additional dependencies + +#### Examples + +```lua +custombuildtask { + { ROOT_DIR .. "version.txt" , GEN_DIR .. "src/version.inc", { ROOT_DIR .. "version.py" }, {"@echo Generating version.inc file...", "python $(1) $(<) > $(@)" }}, + } + +``` + +[Back to top](#table-of-contents) + +--- ### debugargs({_args_...}) Specifies a list of arguments to pas to the application when run under the debugger. @@ -395,6 +425,23 @@ defines { "CALLSPEC=__dllexport" } [Back to top](#table-of-contents) --- +### dependency({_main_file, _depending_of_}...) +GMAKE specific adds dependency between source file and any other file. + +**Scope:** solutions, projects, configurations + +#### Arguments +_main_file - name of source file that depends of other file +_depending_of_ - name of dependency file + +#### Examples +```lua +dependency { { ROOT_DIR .. "src/test.c", ROOT_DIR .. "verion.txt" } } +``` + +[Back to top](#table-of-contents) + +--- ### deploymentoptions({_options_...}) Passes arguments directly to the deployment tool command line. Multiple calls are concatenated. @@ -1502,6 +1549,22 @@ configuration "not windows" [Back to top](#table-of-contents) --- +### postcompiletasks({_commands_...}) +Specifies shell commands to run after compile of file is finished +(GMAKE specific) + +**Scope:** solutions, projects, configurations + +#### Arguments +_commands_ - one or more shell commands + +#### Examples +```lua + postcompiletasks { "rm $(@:%.o=%.d)" } +``` +[Back to top](#table-of-contents) + +--- ### prebuildcommands({_commands_...}) Specifies shell commands to run before each build |