diff options
author | laszlocsomor <laszlocsomor@google.com> | 2017-08-25 16:55:42 +0200 |
---|---|---|
committer | Vladimir Moskva <vladmos@google.com> | 2017-08-28 16:07:54 +0200 |
commit | f0ed5d32ad9888ebcecc16ee747aa8638efdb2cc (patch) | |
tree | 8032ac05f7c3d82a51a9bd93b52ec2fb912afd86 /site/docs/install-windows.md | |
parent | 14e4c9161bb9bed6435dd4214533bde5135726c2 (diff) |
docs,Windows: update installation docs
In this change:
- Reword text in windows.md to use active voice
instead of passive voice (so it's clear who the
actor is).
- Update Bash script examples to use cmd.exe
syntax.
- Remove outdated information, such as Bazel being
an msys2 binary.
- Restructure list of requirements to be clearer
and simpler.
RELNOTES: none
PiperOrigin-RevId: 166476459
Diffstat (limited to 'site/docs/install-windows.md')
-rw-r--r-- | site/docs/install-windows.md | 54 |
1 files changed, 27 insertions, 27 deletions
diff --git a/site/docs/install-windows.md b/site/docs/install-windows.md index 2228e2b683..a9a83e3105 100644 --- a/site/docs/install-windows.md +++ b/site/docs/install-windows.md @@ -5,43 +5,43 @@ title: Installing Bazel on Windows # <a name="windows"></a>Install Bazel on Windows -Windows support is in beta. Known issues are [marked with label "Windows"](https://github.com/bazelbuild/bazel/issues?q=is%3Aissue+is%3Aopen+label%3A%22category%3A+multi-platform+%3E+windows%22) -on GitHub. +Bazel runs on 64 bit Windows 7 or higher. -We currently support only 64 bit Windows 7 or higher and we compile Bazel as a -MSYS2 binary. +Known issues are [marked with label +"Windows"](https://github.com/bazelbuild/bazel/issues?q=is%3Aissue+is%3Aopen+label%3A%22category%3A+multi-platform+%3E+windows%22) +on GitHub issues. -Install Bazel on Windows using one of the following methods: +To run Bazel on Windows, make sure your system meets the +[requirements](windows.html#requirements). - * [Use Chocolatey](#install-on-windows-chocolatey) - * [Use the binary distribution](#download-binary-windows) - * [Compile Bazel from source](install-compile-source.md) -- make sure - your machine meets the [requirements](windows.md#requirements) +You can get Bazel for Windows using one of the following methods: +* Download the binary distribution (recommended). -## <a name="install-on-windows-chocolatey"></a>Install using Chocolatey + We provide binary versions on our [GitHub releases + page](https://github.com/bazelbuild/bazel/releases). -You can install the unofficial package using the -[chocolatey](https://chocolatey.org) package manager: + The installer contains only the Bazel binary. You'll need additional + software (e.g. msys2 shell) and some setup in your environment to run Bazel. + You can find these on the [Windows requirements page](windows.html). -```sh -choco install bazel -``` +* Use Chocolatey. -This will install the latest available version of Bazel, and dependencies. + You can install the Bazel package using the + [Chocolatey](https://chocolatey.org) package manager: -This package is experimental. Please provide feedback to `@petemounce` in GitHub -issue tracker. See the [Chocolatey installation and package -maintenance](https://bazel.build/windows-chocolatey-maintenance.html) guide for -more information. + ```sh + choco install bazel + ``` + This command will install the latest available version of Bazel and most of + its dependencies, such as the msys2 shell. This will not install Visual C++ + though. -## <a name="download-binary-windows"></a>Install using the binary distribution + See [Chocolatey installation and package maintenance + guide](https://bazel.build/windows-chocolatey-maintenance.html) for more + information about the Chocolatey package. -We provide binary versions on our -<a href="https://github.com/bazelbuild/bazel/releases">GitHub releases page</a> +* [Compile Bazel from source](install-compile-source.html). -The installer contains only the Bazel binary. You'll need additional software -(e.g. msys2 shell of the right version) and some setup in your environment to -run Bazel. See these requirements on our -[Windows page](windows.md#requirements). +## Next: see [Using Bazel on Windows](windows.html#using) |