From 86e007fdeced120cda3108e97044db4fd817d5f0 Mon Sep 17 00:00:00 2001 From: dannark Date: Tue, 17 Jul 2018 13:59:17 -0700 Subject: Add anchor tags to external.md page for actual linkability! RELNOTES: None PiperOrigin-RevId: 204969740 --- site/docs/external.md | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'site') diff --git a/site/docs/external.md b/site/docs/external.md index 96d9868838..4b19e9695a 100644 --- a/site/docs/external.md +++ b/site/docs/external.md @@ -44,6 +44,7 @@ This `WORKSPACE` file uses the same syntax as BUILD files, but allows a different set of rules. The full list of built-in rules are in the Build Encyclopedia's [Workspace Rules](be/workspace.html). + ## Supported types of external dependencies A few basic types of external dependencies can be used: @@ -120,6 +121,7 @@ files. ### Depending on external packages + #### Maven repositories Use the rule [`maven_jar`](https://docs.bazel.build/be/workspace.html#maven_jar) @@ -127,12 +129,14 @@ Use the rule [`maven_jar`](https://docs.bazel.build/be/workspace.html#maven_jar) to download a jar from a Maven repository and make it available as a Java dependency. + ## Fetching dependencies By default, external dependencies are fetched as needed during `bazel build`. If you would like to disable this behavior or prefetch dependencies, use [`bazel fetch`](http://docs.bazel.build/user-manual.html#fetch). + ## Shadowing dependencies Whenever possible, it is recommended to have a single version policy in your @@ -209,6 +213,7 @@ This behavior is currently gated behind a flag, `--experimental_enable_repo_mapping`. + ## Using Proxies Bazel will pick up proxy addresses from the `HTTPS_PROXY` and `HTTP_PROXY` @@ -228,11 +233,13 @@ Large `WORKSPACE` files can be generated using the tool `generate_workspace`. For details, see [Generate external dependencies from Maven projects](generate-workspace.md). + ## Caching of external dependencies Bazel caches external dependencies and re-downloads or updates them when the `WORKSPACE` file changes. + ## Layout External dependencies are all downloaded and symlinked under a directory named -- cgit v1.2.3