aboutsummaryrefslogtreecommitdiffhomepage
path: root/site
diff options
context:
space:
mode:
authorGravatar dannark <dannark@google.com>2018-07-17 13:59:17 -0700
committerGravatar Copybara-Service <copybara-piper@google.com>2018-07-17 14:01:11 -0700
commit86e007fdeced120cda3108e97044db4fd817d5f0 (patch)
treed352fa90ea06ae932f6d124b27591134178e66f6 /site
parentdfce7407e6922ca5e070c348ad72a1917a54da82 (diff)
Add anchor tags to external.md page for actual linkability!
RELNOTES: None PiperOrigin-RevId: 204969740
Diffstat (limited to 'site')
-rw-r--r--site/docs/external.md7
1 files changed, 7 insertions, 0 deletions
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).
+<a name="types"></a>
## Supported types of external dependencies
A few basic types of external dependencies can be used:
@@ -120,6 +121,7 @@ files.
<a name="external-packages"></a>
### Depending on external packages
+<a name="maven-repositories"></a>
#### 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.
+<a name="fetching-dependencies"></a>
## 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).
+<a name="shadowing-dependencies"></a>
## 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`.
+<a name="using-proxies"></a>
## 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).
+<a name="caching"></a>
## Caching of external dependencies
Bazel caches external dependencies and re-downloads or updates them when
the `WORKSPACE` file changes.
+<a name="layout"></a>
## Layout
External dependencies are all downloaded and symlinked under a directory named