aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/docs/install-windows.md
diff options
context:
space:
mode:
authorGravatar laszlocsomor <laszlocsomor@google.com>2017-08-25 16:55:42 +0200
committerGravatar Vladimir Moskva <vladmos@google.com>2017-08-28 16:07:54 +0200
commitf0ed5d32ad9888ebcecc16ee747aa8638efdb2cc (patch)
tree8032ac05f7c3d82a51a9bd93b52ec2fb912afd86 /site/docs/install-windows.md
parent14e4c9161bb9bed6435dd4214533bde5135726c2 (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.md54
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)