forked from bazelbuild/bazel
-
Notifications
You must be signed in to change notification settings - Fork 7
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add a blog post about simplified workspace creation
-- MOS_MIGRATED_REVID=90442814
- Loading branch information
Showing
2 changed files
with
36 additions
and
0 deletions.
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
36 changes: 36 additions & 0 deletions
36
site/blog/_posts/2015-04-06-Simplified-Workspace-Creation.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,36 @@ | ||
--- | ||
layout: posts | ||
title: Announcing simplified workspace creation | ||
--- | ||
|
||
To create a new workspace, you can now simply create an empty `WORKSPACE` file | ||
in a directory. | ||
|
||
Previously, you'd need to copy or symlink the `tools` directory into your | ||
project, which was unpopular: | ||
|
||
!["move my-project/ to be a subdirectory of base_workspace/" Ok. Ctrl-W.]({{ site_root }}/assets/ctrl-w-tweet.png) | ||
|
||
[Miguel Alcon](https://github.com/mikelalcon) came up with a great idea for | ||
making this process simpler. Now the `compile.sh` script will create a | ||
`.bazelrc` file in your home directory which tells Bazel where `compile.sh` was | ||
run from and, thus, where it can find its tools when you build. | ||
|
||
To use this new functionality, get the latest version of the code from Github, | ||
run `./compile.sh`, and then create a Bazel workspace by running | ||
`touch WORKSPACE` in any directory. | ||
|
||
Some caveats to watch out for: | ||
|
||
* If you move the directory where Bazel was built you will need to | ||
update your `~/.bazelrc` file. | ||
* If you would like to use different tools than the ones `compile.sh` | ||
finds/generates, you can create a `tools/` directory in your project and | ||
Bazel will attempt to use that instead of the system-wide one. | ||
|
||
See the [getting started]({{ site_root }}/docs/getting-started.html) docs for more info about | ||
setting up your workspace. | ||
|
||
Let us know if you have any questions or issues on the | ||
[mailing list](groups.google.com/forum/#!forum/bazel-discuss) or | ||
[GitHub](https://github.com/google/bazel). |