aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRuss Cox <rsc@golang.org>2015-12-17 01:00:14 -0500
committerRuss Cox <rsc@golang.org>2015-12-17 17:00:02 +0000
commitf474885f8a44d3c00e2f11315628fa80fda9404c (patch)
tree3cc4d463d65588cda8125a68e19f30c4cee7faba
parent8fac7e3cc7b69211267d5a2e3c08b0f5cd4c46f9 (diff)
downloadgo-f474885f8a44d3c00e2f11315628fa80fda9404c.tar.gz
go-f474885f8a44d3c00e2f11315628fa80fda9404c.zip
cmd/go: document where get writes, and not vendor directories
Fixes #12260. Change-Id: I95c27aad6de8064b9a205d4ee507bce75926f16d Reviewed-on: https://go-review.googlesource.com/17948 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
-rw-r--r--src/cmd/go/alldocs.go6
-rw-r--r--src/cmd/go/get.go6
2 files changed, 12 insertions, 0 deletions
diff --git a/src/cmd/go/alldocs.go b/src/cmd/go/alldocs.go
index 6fe2b9e2b4..96aed49ee2 100644
--- a/src/cmd/go/alldocs.go
+++ b/src/cmd/go/alldocs.go
@@ -497,6 +497,10 @@ missing packages but does not use it to look for updates to existing packages.
Get also accepts build flags to control the installation. See 'go help build'.
+When checking out a new package, get creates the target directory
+GOPATH/src/<import-path>. If the GOPATH contains multiple entries,
+get uses the first one. See 'go help gopath'.
+
When checking out or updating a package, get looks for a branch or tag
that matches the locally installed version of Go. The most important
rule is that if the local installation is running version "go1", get
@@ -507,6 +511,8 @@ Unless vendoring support is disabled (see 'go help gopath'),
when go get checks out or updates a Git repository,
it also updates any git submodules referenced by the repository.
+Get never checks out or updates code stored in vendor directories.
+
For more about specifying packages, see 'go help packages'.
For more about how 'go get' finds source code to
diff --git a/src/cmd/go/get.go b/src/cmd/go/get.go
index d97afb90de..a298049a9d 100644
--- a/src/cmd/go/get.go
+++ b/src/cmd/go/get.go
@@ -45,6 +45,10 @@ missing packages but does not use it to look for updates to existing packages.
Get also accepts build flags to control the installation. See 'go help build'.
+When checking out a new package, get creates the target directory
+GOPATH/src/<import-path>. If the GOPATH contains multiple entries,
+get uses the first one. See 'go help gopath'.
+
When checking out or updating a package, get looks for a branch or tag
that matches the locally installed version of Go. The most important
rule is that if the local installation is running version "go1", get
@@ -55,6 +59,8 @@ Unless vendoring support is disabled (see 'go help gopath'),
when go get checks out or updates a Git repository,
it also updates any git submodules referenced by the repository.
+Get never checks out or updates code stored in vendor directories.
+
For more about specifying packages, see 'go help packages'.
For more about how 'go get' finds source code to