Chromium Code Reviews| Index: build_overrides/README.md |
| diff --git a/build_overrides/README.md b/build_overrides/README.md |
| new file mode 100644 |
| index 0000000000000000000000000000000000000000..d26312c9325ddcc3126ade50802a6cf879454cb1 |
| --- /dev/null |
| +++ b/build_overrides/README.md |
| @@ -0,0 +1,20 @@ |
| +# Build overrides in GN |
| + |
| +This directory is used to allow different products to customize settings |
| +for repos that are DEPS'ed in or shared. |
| + |
| +For example: V8 could be built on its own (in a "standalone" configuration), |
| +and it could be built as part of Chromium. V8 might define a top-level |
| +target, //v8:d8 (a simple executable), that should only be built in the |
| +standalone configuration. To figure out whether or not it should be |
| +in a standalone configuration, v8 can create a file, build_overrides/v8.gni, |
|
tfarina
2015/10/13 05:11:49
Right, I think with this example I can see how thi
kjellander_chromium
2015/10/13 07:31:35
Yeah, I'm happy for the WebRTC use case, since we
|
| +that contains a variable, `build_standalone_d8 = true`. |
| +and import it (as import("//build_overrides/v8.gni") from its top-level |
| +BUILD.gn file. |
| + |
| +Chromium, on the other hand, might not need to build d8, and so it would |
| +create its own build_overrides/v8.gni file, and in it set |
| +`build_standalone_d8 = false`. |
| + |
| +The two files should define the same set of variables, but the values can |
| +vary as appropriate to the needs of the two different builds. |