| Index: tools/gn/functions_target.cc
|
| diff --git a/tools/gn/functions_target.cc b/tools/gn/functions_target.cc
|
| index 86048376cac6a1ca05cd2258d9acc49f69864f48..becbbabf70067edd14ff9726d1844a26dce8f127 100644
|
| --- a/tools/gn/functions_target.cc
|
| +++ b/tools/gn/functions_target.cc
|
| @@ -70,6 +70,14 @@ Value ExecuteGenericTarget(const char* target_type,
|
| " reference the output or generated intermediate file directories,\n" \
|
| " respectively.\n"
|
|
|
| +#define ACTION_DEPS \
|
| + " The \"deps\" for an action will always be completed before any part\n" \
|
| + " of the action is run so it can depend on the output of previous\n" \
|
| + " steps. The \"datadeps\" will be built if the action is built, but\n" \
|
| + " may not have completed before all steps of the action are started.\n" \
|
| + " This can give additional parallelism in the build for runtime-only\n" \
|
| + " dependencies.\n"
|
| +
|
| const char kAction[] = "action";
|
| const char kAction_HelpShort[] =
|
| "action: Declare a target that runs a script a single time.";
|
| @@ -80,6 +88,8 @@ const char kAction_Help[] =
|
| " or more output files. If you want to run a script once for each of a\n"
|
| " set of input files, see \"gn help action_foreach\".\n"
|
| "\n"
|
| + "Inputs\n"
|
| + "\n"
|
| " In an action the \"sources\" and \"source_prereqs\" are treated the\n"
|
| " same: they're both input dependencies on script execution with no\n"
|
| " special handling. If you want to pass the sources to your script, you\n"
|
| @@ -92,6 +102,10 @@ const char kAction_Help[] =
|
| " variable, and stuff like other Python files required to run your\n"
|
| " script in the \"source_prereqs\" variable.\n"
|
| "\n"
|
| + ACTION_DEPS
|
| + "\n"
|
| + "Outputs\n"
|
| + "\n"
|
| " You should specify files created by your script by specifying them in\n"
|
| " the \"outputs\".\n"
|
| "\n"
|
| @@ -145,6 +159,8 @@ const char kActionForEach_Help[] =
|
| " of sources. If you want to run a script once that takes many files as\n"
|
| " input, see \"gn help action\".\n"
|
| "\n"
|
| + "Inputs\n"
|
| + "\n"
|
| " The script will be run once per file in the \"sources\" variable. The\n"
|
| " \"outputs\" variable should specify one or more files with a source\n"
|
| " expansion pattern in it (see \"gn help source_expansion\"). The output\n"
|
| @@ -156,6 +172,10 @@ const char kActionForEach_Help[] =
|
| " listed in the \"source_prereqs\" variable. These files are treated as\n"
|
| " dependencies of each script invocation.\n"
|
| "\n"
|
| + ACTION_DEPS
|
| + "\n"
|
| + "Outputs\n"
|
| + "\n"
|
| SCRIPT_EXECUTION_CONTEXT
|
| "\n"
|
| "File name handling\n"
|
|
|