aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJay Conrod <jayconrod@google.com>2021-06-18 15:07:00 -0700
committerJay Conrod <jayconrod@google.com>2021-06-21 15:39:45 +0000
commitced0fdbad0655d63d535390b1a7126fd1fef8348 (patch)
tree8eb04bfbd0bfd5ed9f0c8d2a293d4ef045aa694a /doc
parent7a5e7047a4606e1deab7d4adcf9f057c7f8ce88c (diff)
downloadgo-ced0fdbad0655d63d535390b1a7126fd1fef8348.tar.gz
go-ced0fdbad0655d63d535390b1a7126fd1fef8348.zip
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>
Diffstat (limited to 'doc')
-rw-r--r--doc/go1.17.html10
1 files changed, 10 insertions, 0 deletions
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 -->