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

Side by Side Diff: tools/gn/docs/reference.md

Issue 2341683006: Fix various issues with `gn analyze`. (Closed)
Patch Set: update docs Created 4 years, 3 months 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 unified diff | Download patch
« no previous file with comments | « tools/gn/command_analyze.cc ('k') | no next file » | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
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
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
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 ```
OLDNEW
« no previous file with comments | « tools/gn/command_analyze.cc ('k') | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698