diff options
author | Alberto Donizetti <alb.donizetti@gmail.com> | 2019-02-04 20:07:46 +0100 |
---|---|---|
committer | Alberto Donizetti <alb.donizetti@gmail.com> | 2019-02-04 20:20:15 +0000 |
commit | b5be877ba4318422547068b85c673639cd843b7d (patch) | |
tree | ecfd306ad34b03f6bb18f5a4c5a6c81855f89695 | |
parent | 691a2d457ab1bf03bd46d4b69e0f93b8993c0055 (diff) | |
download | go-b5be877ba4318422547068b85c673639cd843b7d.tar.gz go-b5be877ba4318422547068b85c673639cd843b7d.zip |
cmd/go: clarify @none effect on dependants modules
Expand modules documentation to clarify why @none is useful. The
wording is the one suggested by rsc on the issue.
Fixes #26684
Change-Id: I76dc4ff87e50f1dd8536fd9ac1fd938adb29bee3
Reviewed-on: https://go-review.googlesource.com/c/161037
Reviewed-by: Bryan C. Mills <bcmills@google.com>
-rw-r--r-- | src/cmd/go/alldocs.go | 3 | ||||
-rw-r--r-- | src/cmd/go/internal/modget/get.go | 3 |
2 files changed, 4 insertions, 2 deletions
diff --git a/src/cmd/go/alldocs.go b/src/cmd/go/alldocs.go index d5f6369312..186f42156a 100644 --- a/src/cmd/go/alldocs.go +++ b/src/cmd/go/alldocs.go @@ -2496,7 +2496,8 @@ // development module, then get will update the required version. // Specifying a version earlier than the current required version is valid and // downgrades the dependency. The version suffix @none indicates that the -// dependency should be removed entirely. +// dependency should be removed entirely, downgrading or removing modules +// depending on it as needed. // // Although get defaults to using the latest version of the module containing // a named package, it does not use the latest version of that module's diff --git a/src/cmd/go/internal/modget/get.go b/src/cmd/go/internal/modget/get.go index 2bfe6d3bb2..17a0ed45e2 100644 --- a/src/cmd/go/internal/modget/get.go +++ b/src/cmd/go/internal/modget/get.go @@ -56,7 +56,8 @@ If a module under consideration is already a dependency of the current development module, then get will update the required version. Specifying a version earlier than the current required version is valid and downgrades the dependency. The version suffix @none indicates that the -dependency should be removed entirely. +dependency should be removed entirely, downgrading or removing modules +depending on it as needed. Although get defaults to using the latest version of the module containing a named package, it does not use the latest version of that module's |