OLD | NEW |
1 # GN Reference | 1 # GN Reference |
2 | 2 |
3 *This page is automatically generated from* `gn help --markdown all`. | 3 *This page is automatically generated from* `gn help --markdown all`. |
4 | 4 |
5 ## **\--args**: Specifies build arguments overrides. | 5 ## **\--args**: Specifies build arguments overrides. |
6 | 6 |
7 ``` | 7 ``` |
8 See "gn help buildargs" for an overview of how build arguments work. | 8 See "gn help buildargs" for an overview of how build arguments work. |
9 | 9 |
10 Most operations take a build directory. The build arguments are taken | 10 Most operations take a build directory. The build arguments are taken |
(...skipping 241 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
252 | 252 |
253 This command takes three arguments: | 253 This command takes three arguments: |
254 | 254 |
255 out_dir is the path to the build directory. | 255 out_dir is the path to the build directory. |
256 | 256 |
257 input_path is a path to a file containing a JSON object with three | 257 input_path is a path to a file containing a JSON object with three |
258 fields: | 258 fields: |
259 | 259 |
260 - "files": A list of the filenames to check. | 260 - "files": A list of the filenames to check. |
261 | 261 |
262 - "compile_targets": A list of the labels targets that we wish to | 262 - "test_targets": A list of the labels for targets that |
263 rebuild, but aren't necessarily needed for testing. The | 263 are needed to run the tests we wish to run. |
264 important difference between this field and "test_targets" | 264 |
265 is that if an item in the compile_targets list is a group, then | 265 - "additional_compile_targets": A list of the labels for |
| 266 targets that we wish to rebuild, but aren't necessarily needed |
| 267 for testing. The important difference between this field and |
| 268 "test_targets" is that if an item in the |
| 269 additional_compile_targets list refers to a group, then |
266 any dependencies of that group will be returned if they are out | 270 any dependencies of that group will be returned if they are out |
267 of date, but the group itself does not need to be. If the | 271 of date, but the group itself does not need to be. If the |
268 dependencies themselves are groups, the same filtering is | 272 dependencies themselves are groups, the same filtering is |
269 repeated. This filtering can be used to avoid rebuilding | 273 repeated. This filtering can be used to avoid rebuilding |
270 dependencies of a group that are unaffected by the input files. | 274 dependencies of a group that are unaffected by the input files. |
271 The list may contain the string "all" to refer to a | 275 The list may also contain the string "all" to refer to a |
272 pseudo-group that contains every root target in the build graph. | 276 pseudo-group that contains every root target in the build |
| 277 graph. |
273 | 278 |
274 This filtering behavior is also known as "pruning" the list | 279 This filtering behavior is also known as "pruning" the list |
275 of compile targets. | 280 of compile targets. |
276 | 281 |
277 - "test_targets": A list of the labels for targets that | |
278 are needed to run the tests we wish to run. Unlike | |
279 "compile_targets", this list may not contain the string "all", | |
280 because having a test be dependent on everything in the build | |
281 would be silly. | |
282 | |
283 output_path is a path indicating where the results of the command | 282 output_path is a path indicating where the results of the command |
284 are to be written. The results will be a file containing a JSON | 283 are to be written. The results will be a file containing a JSON |
285 object with one or more of following fields: | 284 object with one or more of following fields: |
286 | 285 |
287 - "compile_targets": A list of the labels derived from the input | 286 - "compile_targets": A list of the labels derived from the input |
288 compile_targets list that are affected by the input files. | 287 compile_targets list that are affected by the input files. |
289 Due to the way the filtering works for compile targets as | 288 Due to the way the filtering works for compile targets as |
290 described above, this list may contain targets that do not appear | 289 described above, this list may contain targets that do not appear |
291 in the input list. | 290 in the input list. |
292 | 291 |
(...skipping 6231 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
6524 ** \--root**: Explicitly specify source root. | 6523 ** \--root**: Explicitly specify source root. |
6525 ** \--runtime-deps-list-file**: Save runtime dependencies for targets in file. | 6524 ** \--runtime-deps-list-file**: Save runtime dependencies for targets in file. |
6526 ** \--script-executable**: Set the executable used to execute scripts. | 6525 ** \--script-executable**: Set the executable used to execute scripts. |
6527 ** \--threads**: Specify number of worker threads. | 6526 ** \--threads**: Specify number of worker threads. |
6528 ** \--time**: Outputs a summary of how long everything took. | 6527 ** \--time**: Outputs a summary of how long everything took. |
6529 ** \--tracelog**: Writes a Chrome-compatible trace log to the given file. | 6528 ** \--tracelog**: Writes a Chrome-compatible trace log to the given file. |
6530 ** -v**: Verbose logging. | 6529 ** -v**: Verbose logging. |
6531 ** \--version**: Prints the GN version number and exits. | 6530 ** \--version**: Prints the GN version number and exits. |
6532 | 6531 |
6533 ``` | 6532 ``` |
OLD | NEW |