aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndrew Gerrand <adg@golang.org>2012-03-13 15:02:14 +1100
committerAndrew Gerrand <adg@golang.org>2012-03-13 15:02:14 +1100
commitcf46040784ad13ccd88aaea70e31f1dd89748cf9 (patch)
treefaa5c2d11c68200af474474c7012a66dc4d5a821
parent6033a48b775365714be86462f7e2480e881e978b (diff)
downloadgo-cf46040784ad13ccd88aaea70e31f1dd89748cf9.tar.gz
go-cf46040784ad13ccd88aaea70e31f1dd89748cf9.zip
doc: windows zip archive installation instructions
Fixes #3254. R=golang-dev, r CC=golang-dev https://golang.org/cl/5794071
-rw-r--r--doc/install.html42
1 files changed, 41 insertions, 1 deletions
diff --git a/doc/install.html b/doc/install.html
index 83e98bd0d3..909f82fd4a 100644
--- a/doc/install.html
+++ b/doc/install.html
@@ -51,7 +51,8 @@ OS/arch combination you may want to try
<p>
The Go binary distributions assume they will be installed in
-<code>/usr/local/go</code>, but it is possible to install them in a different
+<code>/usr/local/go</code> (or <code>c:\Go</code> under Windows),
+but it is possible to install them in a different
location. If you do this, you will need to set the <code>GOROOT</code>
environment variable to that directory when using the Go tools.
</p>
@@ -66,6 +67,11 @@ export GOROOT=$HOME/go
export PATH=$PATH:$GOROOT/bin
</pre>
+<p>
+Windows users should read the section about <a href="#windows_env">setting
+environment variables under Windows</a>.
+</p>
+
<h3 id="freebsd_linux">FreeBSD and Linux</h3>
<p>
@@ -114,6 +120,15 @@ Terminal sessions for the change to take effect.
<h3 id="windows">Windows</h3>
<p>
+The Go project provides two installation options for Windows users
+(besides <a href="/doc/install/source">installing from source</a>):
+an MSI installer that configures your installation automatically,
+and a zip archive that requires you to set some environment variables.
+</p>
+
+<h4 id="windows_msi">MSI installer</h3>
+
+<p>
Open the <code>.msi</code> file and follow the prompts to install the Go tools.
By default, the installer puts the Go distribution in <code>c:\Go</code>.
</p>
@@ -124,6 +139,31 @@ The installer should put the <code>c:\Go\bin</code> directory in your
command prompts for the change to take effect.
</p>
+<h4 id="windows_zip">Zip archive</h3>
+
+<p>
+Extract the <code>.zip</code> file to the directory of your choice (we
+suggest <code>c:\Go</code>).
+</p>
+
+<p>
+If you chose a directory other than <code>c:\Go</code>, you must set
+the <code>GOROOT</code> environment variable to your chosen path.
+</p>
+
+<p>
+Add the <code>bin</code> subdirectory of your Go root (for example, <code>c:\Go\bin</code>) to to your <code>PATH</code> environment variable.
+</p>
+
+<h4 id="windows_env">Setting environment variables under Windows</h4>
+
+<p>
+Under Windows, you may set environment variables through the "Environment
+Variables" button on the "Advanced" tab of the "System" control panel. Some
+versions of Windows provide this control panel through the "Advanced System
+Settings" option inside the "System" control panel.
+</p>
+
<h2 id="testing">Testing your installation</h2>
<p>