qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-17 06:04:47 -07:00
Code Releases Activity

cmd/go: document GO111MODULE=auto behavior for Go 1.13

Browse Source 
Fixes #31857

Change-Id: Ic4afe1262d863112db97794edc1ade20f6926d64
Reviewed-on: https://go-review.googlesource.com/c/go/+/180197
Reviewed-by: Jay Conrod <jayconrod@google.com>
This commit is contained in:
Bryan C. Mills 2019-06-03 12:13:54 -04:00
parent 98100c56da
commit 2ce643d3b6
2 changed files with 26 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
src/cmd/go/alldocs.go
View File

@ -2260,23 +2260,26 @@
// //
// Module support // Module support
// //
// Go 1.13 includes official support for Go modules, // Go 1.13 includes support for Go modules. Module-aware mode is active by default
// including a module-aware 'go get' command. // whenever a go.mod file is found in, or in a parent of, the current directory.
// Module-aware mode is active by default. //
// The quickest way to take advantage of module support is to check out your
// repository, create a go.mod file (described in the next section) there, and run
// go commands from within that file tree.
// //
// For more fine-grained control, Go 1.13 continues to respect // For more fine-grained control, Go 1.13 continues to respect
// a temporary environment variable, GO111MODULE, which can be set to one // a temporary environment variable, GO111MODULE, which can be set to one
// of three string values: off, auto, or on (the default). // of three string values: off, on, or auto (the default).
// If GO111MODULE=on or is unset, then the go command requires the use of // If GO111MODULE=on, then the go command requires the use of modules,
// modules, never consulting GOPATH. We refer to this as the command // never consulting GOPATH. We refer to this as the command
// being module-aware or running in "module-aware mode". // being module-aware or running in "module-aware mode".
// If GO111MODULE=auto, then the go command enables or disables module
// support based on the current directory. Module support is enabled only
// when the current directory is outside GOPATH/src and itself contains a
// go.mod file or is below a directory containing a go.mod file.
// If GO111MODULE=off, then the go command never uses // If GO111MODULE=off, then the go command never uses
// module support. Instead it looks in vendor directories and GOPATH // module support. Instead it looks in vendor directories and GOPATH
// to find dependencies; we now refer to this as "GOPATH mode." // to find dependencies; we now refer to this as "GOPATH mode."
// If GO111MODULE=auto or is unset, then the go command enables or disables
// module support based on the current directory.
// Module support is enabled only when the current directory contains a
// go.mod file or is below a directory containing a go.mod file.
// //
// In module-aware mode, GOPATH no longer defines the meaning of imports // In module-aware mode, GOPATH no longer defines the meaning of imports
// during a build, but it still stores downloaded dependencies (in GOPATH/pkg/mod) // during a build, but it still stores downloaded dependencies (in GOPATH/pkg/mod)

23
src/cmd/go/internal/modload/help.go
View File

@ -21,23 +21,26 @@ which source files are used in a given build.
Module support Module support
Go 1.13 includes official support for Go modules, Go 1.13 includes support for Go modules. Module-aware mode is active by default
including a module-aware 'go get' command. whenever a go.mod file is found in, or in a parent of, the current directory.
Module-aware mode is active by default.
The quickest way to take advantage of module support is to check out your
repository, create a go.mod file (described in the next section) there, and run
go commands from within that file tree.
For more fine-grained control, Go 1.13 continues to respect For more fine-grained control, Go 1.13 continues to respect
a temporary environment variable, GO111MODULE, which can be set to one a temporary environment variable, GO111MODULE, which can be set to one
of three string values: off, auto, or on (the default). of three string values: off, on, or auto (the default).
If GO111MODULE=on or is unset, then the go command requires the use of If GO111MODULE=on, then the go command requires the use of modules,
modules, never consulting GOPATH. We refer to this as the command never consulting GOPATH. We refer to this as the command
being module-aware or running in "module-aware mode". being module-aware or running in "module-aware mode".
If GO111MODULE=auto, then the go command enables or disables module
support based on the current directory. Module support is enabled only
when the current directory is outside GOPATH/src and itself contains a
go.mod file or is below a directory containing a go.mod file.
If GO111MODULE=off, then the go command never uses If GO111MODULE=off, then the go command never uses
module support. Instead it looks in vendor directories and GOPATH module support. Instead it looks in vendor directories and GOPATH
to find dependencies; we now refer to this as "GOPATH mode." to find dependencies; we now refer to this as "GOPATH mode."
If GO111MODULE=auto or is unset, then the go command enables or disables
module support based on the current directory.
Module support is enabled only when the current directory contains a
go.mod file or is below a directory containing a go.mod file.
In module-aware mode, GOPATH no longer defines the meaning of imports In module-aware mode, GOPATH no longer defines the meaning of imports
during a build, but it still stores downloaded dependencies (in GOPATH/pkg/mod) during a build, but it still stores downloaded dependencies (in GOPATH/pkg/mod)