Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(7)

Unified Diff: tools/gn/function_exec_script.cc

Issue 2481423002: Convert gn docstrings to C++11 raw strings. (Closed)
Patch Set: Fixes Created 4 years, 1 month ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « tools/gn/docs/reference.md ('k') | tools/gn/function_foreach.cc » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
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,
« no previous file with comments | « tools/gn/docs/reference.md ('k') | tools/gn/function_foreach.cc » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698