Index: tools/gn/function_exec_script.cc |
diff --git a/tools/gn/function_exec_script.cc b/tools/gn/function_exec_script.cc |
index 231693b5d2e7b2a6317bdb70c343b30286e2e13d..8c4909c372fb3f4dbb85e838d8cefb4d0880bf60 100644 |
--- a/tools/gn/function_exec_script.cc |
+++ b/tools/gn/function_exec_script.cc |
@@ -63,57 +63,57 @@ const char kExecScript[] = "exec_script"; |
const char kExecScript_HelpShort[] = |
"exec_script: Synchronously run a script and return the output."; |
const char kExecScript_Help[] = |
- "exec_script: Synchronously run a script and return the output.\n" |
- "\n" |
- " exec_script(filename,\n" |
- " arguments = [],\n" |
- " input_conversion = \"\",\n" |
- " file_dependencies = [])\n" |
- "\n" |
- " Runs the given script, returning the stdout of the script. The build\n" |
- " generation will fail if the script does not exist or returns a nonzero\n" |
- " exit code.\n" |
- "\n" |
- " The current directory when executing the script will be the root\n" |
- " build directory. If you are passing file names, you will want to use\n" |
- " the rebase_path() function to make file names relative to this\n" |
- " path (see \"gn help rebase_path\").\n" |
- "\n" |
- "Arguments:\n" |
- "\n" |
- " filename:\n" |
- " File name of python script to execute. Non-absolute names will\n" |
- " be treated as relative to the current build file.\n" |
- "\n" |
- " arguments:\n" |
- " A list of strings to be passed to the script as arguments.\n" |
- " May be unspecified or the empty list which means no arguments.\n" |
- "\n" |
- " input_conversion:\n" |
- " Controls how the file is read and parsed.\n" |
- " See \"gn help input_conversion\".\n" |
- "\n" |
- " If unspecified, defaults to the empty string which causes the\n" |
- " script result to be discarded. exec script will return None.\n" |
- "\n" |
- " dependencies:\n" |
- " (Optional) A list of files that this script reads or otherwise\n" |
- " depends on. These dependencies will be added to the build result\n" |
- " such that if any of them change, the build will be regenerated and\n" |
- " the script will be re-run.\n" |
- "\n" |
- " The script itself will be an implicit dependency so you do not\n" |
- " need to list it.\n" |
- "\n" |
- "Example:\n" |
- "\n" |
- " all_lines = exec_script(\n" |
- " \"myscript.py\", [some_input], \"list lines\",\n" |
- " [ rebase_path(\"data_file.txt\", root_build_dir) ])\n" |
- "\n" |
- " # This example just calls the script with no arguments and discards\n" |
- " # the result.\n" |
- " exec_script(\"//foo/bar/myscript.py\")\n"; |
+ R"(exec_script: Synchronously run a script and return the output. |
+ |
+ exec_script(filename, |
+ arguments = [], |
+ input_conversion = "", |
+ file_dependencies = []) |
+ |
+ Runs the given script, returning the stdout of the script. The build |
+ generation will fail if the script does not exist or returns a nonzero exit |
+ code. |
+ |
+ The current directory when executing the script will be the root build |
+ directory. If you are passing file names, you will want to use the |
+ rebase_path() function to make file names relative to this path (see "gn help |
+ rebase_path"). |
+ |
+Arguments: |
+ |
+ filename: |
+ File name of python script to execute. Non-absolute names will be treated |
+ as relative to the current build file. |
+ |
+ arguments: |
+ A list of strings to be passed to the script as arguments. May be |
+ unspecified or the empty list which means no arguments. |
+ |
+ input_conversion: |
+ Controls how the file is read and parsed. See "gn help input_conversion". |
+ |
+ If unspecified, defaults to the empty string which causes the script |
+ result to be discarded. exec script will return None. |
+ |
+ dependencies: |
+ (Optional) A list of files that this script reads or otherwise depends |
+ on. These dependencies will be added to the build result such that if any |
+ of them change, the build will be regenerated and the script will be |
+ re-run. |
+ |
+ The script itself will be an implicit dependency so you do not need to |
+ list it. |
+ |
+Example |
+ |
+ all_lines = exec_script( |
+ "myscript.py", [some_input], "list lines", |
+ [ rebase_path("data_file.txt", root_build_dir) ]) |
+ |
+ # This example just calls the script with no arguments and discards the |
+ # result. |
+ exec_script("//foo/bar/myscript.py") |
+)"; |
Value RunExecScript(Scope* scope, |
const FunctionCallNode* function, |