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 4923 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
4934 When generating Xcode project files, only create_bundle target with a | 4934 When generating Xcode project files, only create_bundle target with a |
4935 non-empty product_type will have a corresponding target in Xcode project. | 4935 non-empty product_type will have a corresponding target in Xcode project. |
4936 ``` | 4936 ``` |
4937 ### <a name="public"></a>**public**: Declare public header files for a target. | 4937 ### <a name="public"></a>**public**: Declare public header files for a target. |
4938 | 4938 |
4939 ``` | 4939 ``` |
4940 A list of files that other targets can include. These permissions are checked | 4940 A list of files that other targets can include. These permissions are checked |
4941 via the "check" command (see "gn help check"). | 4941 via the "check" command (see "gn help check"). |
4942 | 4942 |
4943 If no public files are declared, other targets (assuming they have visibility | 4943 If no public files are declared, other targets (assuming they have visibility |
4944 to depend on this target can include any file in the sources list. If this | 4944 to depend on this target) can include any file in the sources list. If this |
4945 variable is defined on a target, dependent targets may only include files on | 4945 variable is defined on a target, dependent targets may only include files on |
4946 this whitelist. | 4946 this whitelist. |
4947 | 4947 |
4948 Header file permissions are also subject to visibility. A target must be | 4948 Header file permissions are also subject to visibility. A target must be |
4949 visible to another target to include any files from it at all and the public | 4949 visible to another target to include any files from it at all and the public |
4950 headers indicate which subset of those files are permitted. See "gn help | 4950 headers indicate which subset of those files are permitted. See "gn help |
4951 visibility" for more. | 4951 visibility" for more. |
4952 | 4952 |
4953 Public files are inherited through the dependency tree. So if there is a | 4953 Public files are inherited through the dependency tree. So if there is a |
4954 dependency A -> B -> C, then A can include C's public headers. However, the | 4954 dependency A -> B -> C, then A can include C's public headers. However, the |
(...skipping 1192 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
6147 * [--root: Explicitly specify source root.](#--root) | 6147 * [--root: Explicitly specify source root.](#--root) |
6148 * [--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) |
6149 * [--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) |
6150 * [--threads: Specify number of worker threads.](#--threads) | 6150 * [--threads: Specify number of worker threads.](#--threads) |
6151 * [--time: Outputs a summary of how long everything took.](#--time) | 6151 * [--time: Outputs a summary of how long everything took.](#--time) |
6152 * [--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) |
6153 * [-v: Verbose logging.](#-v) | 6153 * [-v: Verbose logging.](#-v) |
6154 * [--version: Prints the GN version number and exits.](#--version) | 6154 * [--version: Prints the GN version number and exits.](#--version) |
6155 ``` | 6155 ``` |
6156 | 6156 |
OLD | NEW |