tools/mb/README.md

   1 # MB - The Meta-Build wrapper
   2
   3 MB is a simple wrapper around the GN build tool.
   4
   5 It was originally written as part of the GYP-&gt;GN migration, in order to
   6 provide a uniform interface to either GYP or GN, such that users and bots
   7 can call one script and not need to worry about whether a given bot was
   8 meant to use GN or GYP.
   9
  10 It eventually grew additional functionality and is now still used even
  11 though everything is GN-only.
  12
  13 It supports two main functions:
  14
  15 1. "gen" - the main `gn gen` invocation that generates the Ninja files
  16    needed for the build.
  17
  18 2. "analyze" - the step that takes a list of modified files and a list of
  19    desired targets and reports which targets will need to be rebuilt.
  20
  21 We also use MB as a forcing function to collect all of the different
  22 build configurations that we actually support for Chromium builds into
  23 one place, in `//tools/mb/mb_config.pyl`.
  24
  25 For more information, see:
  26
  27 * [The User Guide](docs/user_guide.md)
  28 * [The Design Spec](docs/design_spec.md)