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

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

Issue 2071573003: GN: Use implicit dependency for binary input deps (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Code review changes Created 4 years, 6 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 | « no previous file | tools/gn/ninja_binary_target_writer.h » ('j') | 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 4770 matching lines...) Expand 10 before | Expand all | Expand 10 after
4781 ``` 4781 ```
4782 4782
4783 ### **Inputs for binary targets** 4783 ### **Inputs for binary targets**
4784 4784
4785 ``` 4785 ```
4786 Any input dependencies will be resolved before compiling any sources. 4786 Any input dependencies will be resolved before compiling any sources.
4787 Normally, all actions that a target depends on will be run before any 4787 Normally, all actions that a target depends on will be run before any
4788 files in a target are compiled. So if you depend on generated headers, 4788 files in a target are compiled. So if you depend on generated headers,
4789 you do not typically need to list them in the inputs section. 4789 you do not typically need to list them in the inputs section.
4790 4790
4791 Inputs for binary targets will be treated as order-only dependencies, 4791 Inputs for binary targets will be treated as implicit dependencies,
4792 meaning that they will be forced up to date before compiling or 4792 meaning that changes in any of the inputs will force all sources in
4793 any files in the target, but changes in the inputs will not 4793 the target to be recompiled. If an input only applies to a subset of
4794 necessarily force the target to compile. This is because it is 4794 source files, you may want to split those into a separate target to
4795 expected that the compiler will report the precise list of input 4795 avoid unnecessary recompiles.
4796 dependencies required to recompile each file once the initial build
4797 is done.
4798 4796
4799 ``` 4797 ```
4800 4798
4801 ### **Example** 4799 ### **Example**
4802 4800
4803 ``` 4801 ```
4804 action("myscript") { 4802 action("myscript") {
4805 script = "domything.py" 4803 script = "domything.py"
4806 inputs = [ "input.data" ] 4804 inputs = [ "input.data" ]
4807 } 4805 }
(...skipping 1378 matching lines...) Expand 10 before | Expand all | Expand 10 after
6186 ** \--root**: Explicitly specify source root. 6184 ** \--root**: Explicitly specify source root.
6187 ** \--runtime-deps-list-file**: Save runtime dependencies for targets in file. 6185 ** \--runtime-deps-list-file**: Save runtime dependencies for targets in file.
6188 ** \--script-executable**: Set the executable used to execute scripts. 6186 ** \--script-executable**: Set the executable used to execute scripts.
6189 ** \--threads**: Specify number of worker threads. 6187 ** \--threads**: Specify number of worker threads.
6190 ** \--time**: Outputs a summary of how long everything took. 6188 ** \--time**: Outputs a summary of how long everything took.
6191 ** \--tracelog**: Writes a Chrome-compatible trace log to the given file. 6189 ** \--tracelog**: Writes a Chrome-compatible trace log to the given file.
6192 ** -v**: Verbose logging. 6190 ** -v**: Verbose logging.
6193 ** \--version**: Prints the GN version number and exits. 6191 ** \--version**: Prints the GN version number and exits.
6194 6192
6195 ``` 6193 ```
OLDNEW
« no previous file with comments | « no previous file | tools/gn/ninja_binary_target_writer.h » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698