From: Bryan C. Mills <bcmills@google.com>
Date: Mon, 11 Dec 2023 16:29:36 +0000 (-0500)
Subject: doc/go1.22: document workspace vendoring
X-Git-Tag: go1.22rc1~45
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=100651b6f2b33d073b54da2ff07601ab3cc029b5;p=gostls13.git

doc/go1.22: document workspace vendoring

For #61422.
Updates #60056.

Change-Id: Ie7c7e12acc173f1ff1644555016e51a52509bd6d
Reviewed-on: https://go-review.googlesource.com/c/go/+/548815
Auto-Submit: Bryan Mills <bcmills@google.com>
Reviewed-by: Michael Matloob <matloob@golang.org>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
---

diff --git a/doc/go1.22.html b/doc/go1.22.html
index 414f30e6fb..631184a0e8 100644
--- a/doc/go1.22.html
+++ b/doc/go1.22.html
@@ -67,7 +67,20 @@ func main() {
 
 <!-- https://go.dev/issue/60056 -->
 <p>
-  <!-- support vendoring in workspace mode -->
+  Commands in <a href="https://go.dev/ref/mod#workspaces">workspaces</a> can now
+  use a <code>vendor</code> directory containing the dependencies of the
+  workspace. The directory is created by
+  <a href="/pkg/cmd/go#hdr-Make_vendored_copy_of_dependencies"><code>go</code> <code>work</code> <code>vendor</code></a>,
+  and used by build commands when the <code>-mod</code> flag is set to
+	<code>vendor</code>, which is the default when a workspace <code>vendor</code>
+  directory is present.
+</p>
+<p>
+  Note that the <code>vendor</code> directory's contents for a workspace are different
+  from those of a single module: if the directory at the root of a workspace also
+  contains one of the modules in the workspace, its <code>vendor</code> directory
+  can contain the dependencies of either the workspace or of the module,
+  but not both.
 </p>
 
 <!-- CL 518775 -->