58f5d9fc2c
See this doc: go/chromium-coil-change for more info
BUG=1210385
Change-Id: I0c1bad1cad0584f5f5137b340c89b19e541285fd
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/2902864
Auto-Submit: John Palmer <jopalmer@chromium.org>
Commit-Queue: Dirk Pranke <dpranke@google.com>
Reviewed-by: Dirk Pranke <dpranke@google.com>
Cr-Commit-Position: refs/heads/master@{#884603}
37 lines
1.6 KiB
Markdown
37 lines
1.6 KiB
Markdown
# About
|
|
`//build` contains:
|
|
* Core GN templates and configuration
|
|
* Core Python build scripts
|
|
|
|
Since this directory is DEPS'ed in by some other repositories (webrtc, pdfium,
|
|
v8, etc), it should be kept as self-contained as possible by not referring
|
|
to files outside of it. Some exceptions exist (`//testing`, select
|
|
`//third_party` subdirectories), but new dependencies tend to break these other
|
|
projects, and so should be avoided.
|
|
|
|
Changes to `//build` should be landed in the Chromium repo. They will then be
|
|
replicated to the stand-alone [build repo](https://chromium.googlesource.com/chromium/src/build)
|
|
by the [gsubtreed tool.](https://chromium.googlesource.com/infra/infra/+/main/infra/services/gsubtreed)
|
|
Note: You can find all directories already available through gsubtreed in the
|
|
[list of all chromium repos](https://chromium.googlesource.com/).
|
|
|
|
## Contents
|
|
* `//build/config` - Common templates via `.gni` files.
|
|
* `//build/toolchain` - GN toolchain definitions.
|
|
* `Other .py files` - Some are used by GN/Ninja. Some by gclient hooks, some
|
|
are just random utilities.
|
|
|
|
Files referenced by `//.gn`:
|
|
* `//build/BUILDCONFIG.gn` - Included by all `BUILD.gn` files.
|
|
* `//build/secondary` - An overlay for `BUILD.gn` files. Enables adding
|
|
`BUILD.gn` to directories that live in sub-repositories.
|
|
* `//build_overrides` -
|
|
Refer to [//build_overrides/README.md](../build_overrides/README.md).
|
|
|
|
## Docs
|
|
|
|
* [Writing GN Templates](docs/writing_gn_templates.md)
|
|
* [Debugging Slow Builds](docs/debugging_slow_builds.md)
|
|
* [Mac Hermetic Toolchains](docs/mac_hermetic_toolchain.md)
|
|
* [Android Build Documentation](android/docs/README.md)
|