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 ## Contents | 5 ## Contents |
6 | 6 |
7 * [Commands](#commands) | 7 * [Commands](#commands) |
8 * [analyze: Analyze which targets are affected by a list of files.](#analy
ze) | 8 * [analyze: Analyze which targets are affected by a list of files.](#analy
ze) |
9 * [args: Display or configure arguments declared by the build.](#args) | 9 * [args: Display or configure arguments declared by the build.](#args) |
10 * [check: Check header dependencies.](#check) | 10 * [check: Check header dependencies.](#check) |
(...skipping 5843 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
5854 //tools/gn -> //tools/gn:gn | 5854 //tools/gn -> //tools/gn:gn |
5855 ``` | 5855 ``` |
5856 ### <a name="ninja_rules"></a>**Ninja build rules** | 5856 ### <a name="ninja_rules"></a>**Ninja build rules** |
5857 | 5857 |
5858 #### **The "all" and "default" rules** | 5858 #### **The "all" and "default" rules** |
5859 | 5859 |
5860 ``` | 5860 ``` |
5861 All generated targets (see "gn help execution") will be added to an implicit | 5861 All generated targets (see "gn help execution") will be added to an implicit |
5862 build rule called "all" so "ninja all" will always compile everything. The | 5862 build rule called "all" so "ninja all" will always compile everything. The |
5863 default rule will be used by Ninja if no specific target is specified (just | 5863 default rule will be used by Ninja if no specific target is specified (just |
5864 typing "ninja"). If there is a target named "//:default" it will be the | 5864 typing "ninja"). If there is a target named "default" in the root build file, |
5865 default build rule, otherwise the implicit "all" rule will be used. | 5865 it will be the default build rule, otherwise the implicit "all" rule will be |
| 5866 used. |
5866 ``` | 5867 ``` |
5867 | 5868 |
5868 #### **Phony rules** | 5869 #### **Phony rules** |
5869 | 5870 |
5870 ``` | 5871 ``` |
5871 GN generates Ninja "phony" rules for targets in the default toolchain. The | 5872 GN generates Ninja "phony" rules for targets in the default toolchain. The |
5872 phony rules can collide with each other and with the names of generated files | 5873 phony rules can collide with each other and with the names of generated files |
5873 so are generated with the following priority: | 5874 so are generated with the following priority: |
5874 | 5875 |
5875 1. Actual files generated by the build always take precedence. | 5876 1. Actual files generated by the build always take precedence. |
(...skipping 270 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
6146 * [--root: Explicitly specify source root.](#--root) | 6147 * [--root: Explicitly specify source root.](#--root) |
6147 * [--runtime-deps-list-file: Save runtime dependencies for targets in file
.](#--runtime-deps-list-file) | 6148 * [--runtime-deps-list-file: Save runtime dependencies for targets in file
.](#--runtime-deps-list-file) |
6148 * [--script-executable: Set the executable used to execute scripts.](#--sc
ript-executable) | 6149 * [--script-executable: Set the executable used to execute scripts.](#--sc
ript-executable) |
6149 * [--threads: Specify number of worker threads.](#--threads) | 6150 * [--threads: Specify number of worker threads.](#--threads) |
6150 * [--time: Outputs a summary of how long everything took.](#--time) | 6151 * [--time: Outputs a summary of how long everything took.](#--time) |
6151 * [--tracelog: Writes a Chrome-compatible trace log to the given file.](#-
-tracelog) | 6152 * [--tracelog: Writes a Chrome-compatible trace log to the given file.](#-
-tracelog) |
6152 * [-v: Verbose logging.](#-v) | 6153 * [-v: Verbose logging.](#-v) |
6153 * [--version: Prints the GN version number and exits.](#--version) | 6154 * [--version: Prints the GN version number and exits.](#--version) |
6154 ``` | 6155 ``` |
6155 | 6156 |
OLD | NEW |