| commit | 0c1e3517814fafdb7cd331073f91df38af1a5b56 | [log] [tgz] |
|---|---|---|
| author | nharmata <nharmata@google.com> | Thu May 27 16:08:36 2021 -0700 |
| committer | Copybara-Service <copybara-worker@google.com> | Thu May 27 16:10:05 2021 -0700 |
| tree | a3216b049c3237a7f017eb532b65910e30ad8b7c | |
| parent | d97e8c9dd09ba4678163806d33f6faf8cabfa838 [diff] |
Document some of the pitfalls with `buildfiles` and `loadfiles`. Summary of the background: * Imo: these query operators were a mistake, for the reasons stated in the new documentation (Blaze assumes targets exist, and therefore the operators inherently don't compose). * To fix the pitfalls, we'd need to remove the operators OR drastically change their semantics (to the point of making them no longer useful for their original purpose). Neither of these are realistic approaches. * We could mitigate some of the pitfalls by banning the use of `buildfiles` and `loadfiles` in conjunction with certain values of `--output`. This would require effort to migrate existing users. The team has never had the staffing for this effort. * Documenting the pitfalls is better than nothing, and I should have at least done that back in 2017 when I first noted them. PiperOrigin-RevId: 376270169
{Fast, Correct} - Choose two
Build and test software of any size, quickly and reliably.
Speed up your builds and tests: Bazel rebuilds only what is necessary. With advanced local and distributed caching, optimized dependency analysis and parallel execution, you get fast and incremental builds.
One tool, multiple languages: Build and test Java, C++, Android, iOS, Go, and a wide variety of other language platforms. Bazel runs on Windows, macOS, and Linux.
Scalable: Bazel helps you scale your organization, codebase, and continuous integration solution. It handles codebases of any size, in multiple repositories or a huge monorepo.
Extensible to your needs: Easily add support for new languages and platforms with Bazel's familiar extension language. Share and re-use language rules written by the growing Bazel community.
Follow our tutorials:
See CONTRIBUTING.md
