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

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

Issue 2514333005: Add support for customizing GN's args text. (Closed)
Patch Set: Created 4 years, 1 month 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
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 from 10 Most operations take a build directory. The build arguments are taken from
(...skipping 5828 matching lines...) Expand 10 before | Expand all | Expand 10 after
5839 for a BUILD.gn file (or the build config file discussed above), the file 5839 for a BUILD.gn file (or the build config file discussed above), the file
5840 will first be looked for in the source root. If it's not found, the 5840 will first be looked for in the source root. If it's not found, the
5841 secondary source root will be checked (which would contain a parallel 5841 secondary source root will be checked (which would contain a parallel
5842 directory hierarchy). 5842 directory hierarchy).
5843 5843
5844 This behavior is intended to be used when BUILD.gn files can't be checked 5844 This behavior is intended to be used when BUILD.gn files can't be checked
5845 in to certain source directories for whatever reason. 5845 in to certain source directories for whatever reason.
5846 5846
5847 The secondary source root must be inside the main source tree. 5847 The secondary source root must be inside the main source tree.
5848 5848
5849 arg_file_template [optional]
5850 Label of a file that contains the text that should be used as the
5851 default args.gn file when you run `gn args`.
5852
5849 ``` 5853 ```
5850 5854
5851 ### **Example .gn file contents** 5855 ### **Example .gn file contents**
5852 5856
5853 ``` 5857 ```
5854 buildconfig = "//build/config/BUILDCONFIG.gn" 5858 buildconfig = "//build/config/BUILDCONFIG.gn"
5855 5859
5856 check_targets = [ 5860 check_targets = [
5857 "//doom_melon/*", # Check everything in this subtree. 5861 "//doom_melon/*", # Check everything in this subtree.
5858 "//tools:mind_controlling_ant", # Check this specific target. 5862 "//tools:mind_controlling_ant", # Check this specific target.
(...skipping 786 matching lines...) Expand 10 before | Expand all | Expand 10 after
6645 ** \--root**: Explicitly specify source root. 6649 ** \--root**: Explicitly specify source root.
6646 ** \--runtime-deps-list-file**: Save runtime dependencies for targets in file. 6650 ** \--runtime-deps-list-file**: Save runtime dependencies for targets in file.
6647 ** \--script-executable**: Set the executable used to execute scripts. 6651 ** \--script-executable**: Set the executable used to execute scripts.
6648 ** \--threads**: Specify number of worker threads. 6652 ** \--threads**: Specify number of worker threads.
6649 ** \--time**: Outputs a summary of how long everything took. 6653 ** \--time**: Outputs a summary of how long everything took.
6650 ** \--tracelog**: Writes a Chrome-compatible trace log to the given file. 6654 ** \--tracelog**: Writes a Chrome-compatible trace log to the given file.
6651 ** -v**: Verbose logging. 6655 ** -v**: Verbose logging.
6652 ** \--version**: Prints the GN version number and exits. 6656 ** \--version**: Prints the GN version number and exits.
6653 6657
6654 ``` 6658 ```
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698