Commit 858b9647 authored by brettw's avatar brettw Committed by Commit bot

Add readme for build/args directory.

Review URL: https://codereview.chromium.org/1613283002

Cr-Commit-Position: refs/heads/master@{#370751}
parent f10b7732
This directory is here to hold .gni files that contain sets of GN build
arguments for given configurations.
(Currently this directory is empty because we removed the only thing here, but
this has come up several times so I'm confident we'll need this again. If this
directory is still empty by 2017, feel free to delete it. --Brett)
Some projects or bots may have build configurations with specific combinations
of flags. Rather than making a new global flag for your specific project and
adding it all over the build to each arg it should affect, you can add a .gni
file here with the variables.
For example, for project foo you may put in build/args/foo.gni:
target_os = "android"
use_pulseaudio = false
use_ozone = true
system_libdir = "foo"
Users wanting to build this configuration would run:
$ gn args out/mybuild
And add the following line to their args for that build directory:
import("//build/args/foo.gni")
# You can set any other args here like normal.
is_component_build = false
This way everybody can agree on a set of flags for a project, and their builds
stay in sync as the flags in foo.gni are modified.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment