From: Jay Conrod <jayconrod@google.com>
Date: Fri, 18 Jun 2021 22:07:00 +0000 (-0700)
Subject: doc/go1.17: note deprecation of 'go get' for installing commands
X-Git-Tag: go1.17rc1~71
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=ced0fdbad0;p=gostls13.git

doc/go1.17: note deprecation of 'go get' for installing commands

Fixes #43684

Change-Id: I8982f6816c002c71e62f37a926c8543e34b8b785
Reviewed-on: https://go-review.googlesource.com/c/go/+/329549
Trust: Jay Conrod <jayconrod@google.com>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
---

diff --git a/doc/go1.17.html b/doc/go1.17.html
index c9b64da244..02cd18d037 100644
--- a/doc/go1.17.html
+++ b/doc/go1.17.html
@@ -214,6 +214,16 @@ Do not send CLs removing the interior tags from such phrases.
   <code>environment</code> for details.
 </p>
 
+<p><!-- golang.org/issue/43684 -->
+  <code>go</code> <code>get</code> prints a deprecation warning when installing
+  commands outside the main module (without the <code>-d</code> flag).
+  <code>go</code> <code>install</code> <code>cmd@version</code> should be used
+  instead to install a command at a specific version, using a suffix like
+  <code>@latest</code> or <code>@v1.2.3</code>. In Go 1.18, the <code>-d</code>
+  flag will always be enabled, and <code>go</code> <code>get</code> will only
+  be used to change dependencies in <code>go.mod</code>.
+</p>
+
 <h4 id="missing-go-directive"><code>go.mod</code> files missing <code>go</code> directives</h4>
 
 <p><!-- golang.org/issue/44976 -->