From: Michael Matloob <matloob@golang.org>
Date: Thu, 10 Jun 2021 21:02:44 +0000 (-0400)
Subject: doc/go1.17: document go run pkg@version
X-Git-Tag: go1.17rc1~98
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=033d885315dd67c509d6f7f12f3e3a26bb1ca127;p=gostls13.git

doc/go1.17: document go run pkg@version

Fixes #46687

Change-Id: I6c311f15d3871a9824306b901fa0b81818ed2df8
Reviewed-on: https://go-review.googlesource.com/c/go/+/326870
Trust: Michael Matloob <matloob@golang.org>
Run-TryBot: Michael Matloob <matloob@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Bryan C. Mills <bcmills@google.com>
---

diff --git a/doc/go1.17.html b/doc/go1.17.html
index 642bd60149..75c05c9e25 100644
--- a/doc/go1.17.html
+++ b/doc/go1.17.html
@@ -292,6 +292,18 @@ Do not send CLs removing the interior tags from such phrases.
   <a href="https://golang.org/design/draft-gobuild">https://golang.org/design/draft-gobuild</a>.
 </p>
 
+<h4 id="go run"><code>go</code> <code>run</code></h4>
+
+<p><!-- golang.org/issue/42088 -->
+  <code>go</code> <code>run</code> now accepts arguments with version suffixes
+  (for example, <code>go</code> <code>run</code>
+  <code>example.com/cmd@v1.0.0</code>).  This causes <code>go</code>
+  <code>run</code> to build and run packages in module-aware mode, ignoring the
+  <code>go.mod</code> file in the current directory or any parent directory, if
+  there is one. This is useful for running executables without installing them or
+  without changing dependencies of the current module.
+</p>
+
 <h3 id="gofmt">Gofmt</h3>
 
 <p>