diff options
| author |  Kristina Chodorow <kchodorow@google.com> | 2015-11-25 18:15:58 +0000 |
|---|---|---|
| committer |  Philipp Wollermann <philwo@google.com> | 2015-11-26 13:18:15 +0000 |
| commit | ea19988d7f4745af9b9df163774256c9fad0cf20 (patch) | |
| tree | f3c0aaf81cfe8b5d00ff0904f43822ed2522b6c8 /site/docs/external.md | |
| parent | 92d8f82161eaf59f48ec7465e01c53f877e030b2 (diff) | |
External repository documentation improvements
--
MOS_MIGRATED_REVID=108717933
Diffstat (limited to 'site/docs/external.md')
| -rw-r--r-- | site/docs/external.md | 14 |
1 files changed, 13 insertions, 1 deletions
diff --git a/site/docs/external.md b/site/docs/external.md index f8fbc64499..423e6f7c4f 100644 --- a/site/docs/external.md +++ b/site/docs/external.md @@ -17,6 +17,16 @@ rules. See the full list of rules that are allowed in the [Workspace](/docs/be/workspace.html) list of rules in the Build Encyclopedia. +External dependencies are all downloaded and symlinked under a directory named +`external`. You can see this directory by running: + +``` +ls $(bazel info output_base)/external +``` + +Note that running `bazel clean` will not actually delete the external +directory: to remove all external artifacts, use `bazel clean --expunge`. + ## Fetching dependencies By default, external dependencies are fetched as needed during `bazel build`. If @@ -34,7 +44,9 @@ file size, but hopefully limits the chances of having one library include `C` at version 1.0 and another include `C` at 2.0. Bazel provides a tool to help generate these expansive `WORKSPACE` files, called -`generate_workspace`. Run the following to build the tool and see usage: +`generate_workspace`. This is not included with the binary installer, so you'll +need to clone the [GitHub repo](https://github.com/bazelbuild/bazel) to use it. +`cd` to the GitHub clone and run the following to build the tool and see usage: ``` bazel run //src/tools/generate_workspace |