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 4770 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
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 Loading... |
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 ``` |
OLD | NEW |