build/README.md

   1 # About
   2 `//build` contains:
   3  * Core GN templates and configuration
   4  * Core Python build scripts
   5
   6 Since this directory is DEPS'ed in by some other repositories (webrtc, pdfium,
   7 v8, etc), it should be kept as self-contained as possible by not referring
   8 to files outside of it. Some exceptions exist (`//testing`, select
   9 `//third_party` subdirectories), but new dependencies tend to break these other
  10 projects, and so should be avoided.
  11
  12 Changes to //build should be landed in the Chromium repo. They will then be
  13 replicated to the stand-alone [build repo](https://chromium.googlesource.com/chromium/src/build)
  14 by the [gsubtreed tool.](https://chromium.googlesource.com/infra/infra/+/master/infra/services/gsubtreed)
  15
  16 ## Contents
  17  * `//build/config` - Common templates via `.gni` files.
  18  * `//build/toolchain` - GN toolchain definitions.
  19  * `Other .py files` - Some are used by GN/Ninja. Some by gclient hooks, some
  20    are just random utilities.
  21
  22 Files referenced by `//.gn`:
  23  * `//build/BUILDCONFIG.gn` - Included by all `BUILD.gn` files.
  24  * `//build/secondary` - An overlay for `BUILD.gn` files. Enables adding
  25    `BUILD.gn` to directories that live in sub-repositories.
  26  * `//build_overrides` -
  27    Refer to [//build_overrides/README.md](../build_overrides/README.md).
  28
  29 ## Docs
  30
  31 * [Writing GN Templates](docs/writing_gn_templates.md)
  32 * [Debugging Slow Builds](docs/debugging_slow_builds.md)
  33 * [Mac Hermetic Toolchains](docs/mac_hermetic_toolchain.md)
  34 * [Android Build Documentation](android/docs/README.md)