| 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 |