README.txt
1This directory is here to hold .gni files that contain sets of GN build
2arguments for given configurations.
3
4Some projects or bots may have build configurations with specific combinations
5of flags. Rather than making a new global flag for your specific project and
6adding it all over the build to each arg it should affect, you can add a .gni
7file here with the variables.
8
9For example, for project foo you may put in build/args/foo.gni:
10
11 target_os = "android"
12 use_pulseaudio = false
13 use_ozone = true
14 system_libdir = "foo"
15
16Users wanting to build this configuration would run:
17
18 $ gn args out/mybuild
19
20And add the following line to their args for that build directory:
21
22 import("//build/args/foo.gni")
23 # You can set any other args here like normal.
24 is_component_build = false
25
26This way everybody can agree on a set of flags for a project, and their builds
27stay in sync as the flags in foo.gni are modified.
28