_content/doc: emphasize need to remove existing installations
This change updates the Linux installation instructions to emphasize
the need to delete an existing Go tree in /usr/local/go before
untarring the downloaded archive.
This is a common mistake people seem to make on Linux, and it's known
to produce broken Go installations.
Updates golang/go#51760
Change-Id: Ia7375957a6034defc708add74cf3c2cf4dbee5d4
Reviewed-on: https://go-review.googlesource.com/c/website/+/393755
Run-TryBot: Alberto Donizetti <alb.donizetti@gmail.com>
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Jamal Carvalho <jamalcarvalho@google.com>
Trust: Ian Lance Taylor <iant@google.com>
diff --git a/_content/doc/install.html b/_content/doc/install.html
index 06dfe85..e6758bc 100644
--- a/_content/doc/install.html
+++ b/_content/doc/install.html
@@ -81,20 +81,19 @@
>
<ol>
<li>
- Extract the archive you downloaded into /usr/local, creating a Go tree
- in /usr/local/go.
- <p>
- <strong>Important:</strong> This step will remove a previous
- installation at /usr/local/go, if any, prior to extracting.
- Please back up any data before proceeding.
+ <strong>Remove any previous Go installation</strong> by deleting the /usr/local/go folder
+ (if it exists), then extract the archive you just downloaded into /usr/local, creating a fresh
+ Go tree in /usr/local/go:
+ <pre>
+$ rm -rf /usr/local/go && tar -C /usr/local -xzf <span id="linux-filename">go1.14.3.linux-amd64.tar.gz</span>
+</pre>
+ <p>
+ (You may need to run the command as root or through <code>sudo</code>).
</p>
- <p>
- For example, run the following as root or through <code>sudo</code>:
- </p>
- <pre>
-rm -rf /usr/local/go && tar -C /usr/local -xzf <span id="linux-filename">go1.14.3.linux-amd64.tar.gz</span>
-</pre
- >
+ <p>
+ <strong>Do not</strong> untar the archive into an existing /usr/local/go tree. This is known to
+ produce broken Go installations.
+ </p>
</li>
<li>
Add /usr/local/go/bin to the <code>PATH</code> environment variable.
