From ab94ebbdcdcf6dc03574a85aae8984340c3de7f0 Mon Sep 17 00:00:00 2001 From: "Bryan C. Mills" Date: Wed, 26 Jun 2019 15:57:25 -0400 Subject: [PATCH] doc/go1.13: make cmd/go paragraphs more concise Looking at the live release notes on tip.golang.org, the Modules section is much more verbose than the other sections. To some extent that's to be expected, but too much detail in the release notes might discourage folks from consulting the actual documentation. Ensure that topics have clear links and omit unnecessary details. Change-Id: I1ccbc1697fccaf7ca7094c606bd11696c46d87f0 Reviewed-on: https://go-review.googlesource.com/c/go/+/183987 Run-TryBot: Bryan C. Mills Reviewed-by: Jay Conrod TryBot-Result: Gobot Gobot --- doc/go1.13.html | 34 ++++++++++++---------------------- 1 file changed, 12 insertions(+), 22 deletions(-) diff --git a/doc/go1.13.html b/doc/go1.13.html index 9873978cc3..63ba880250 100644 --- a/doc/go1.13.html +++ b/doc/go1.13.html @@ -184,12 +184,9 @@ Do not send CLs removing the interior tags from such phrases. The new GOPRIVATE environment variable indicates module paths that are not publicly available. - It contains a comma-separated list of glob patterns (in the syntax of - path.Match) to be matched against a - prefix of the module path. It serves as the default value for the - lower-level GONOPROXY and GONOSUMDB variables, which - provide finer-grained control over which modules are fetched via proxy and - verified using the checksum database. + It serves as the default value for the lower-level GONOPROXY + and GONOSUMDB variables, which provide finer-grained control over + which modules are fetched via proxy and verified using the checksum database.

@@ -198,13 +195,10 @@ Do not send CLs removing the interior tags from such phrases. URLs or the special token direct, and its default value is now https://proxy.golang.org,direct. When resolving a package - path to its containing module, the go command will try each - possible module path on the first proxy in the list before falling back to the - next. If an HTTPS proxy is unreachable or returns a status code other than 404 - or 410 for a given module path, no subsequent proxy is consulted for that - path. The direct token indicates that the go command - should attempt to fetch the module directly from its origin; - GOPROXY entries after direct are ignored. + path to its containing module, the go command will try all + candidate module paths on each proxy in the list in succession. An unreachable + proxy or HTTP status code other than 404 or 410 terminates the search without + consulting the remaining proxies.

@@ -238,9 +232,10 @@ go env -w GOSUMDB=off

go get

- In module-aware mode, the set of modules updated by - go get -u - is now smaller, and is more consistent with the set of packages updated by + In module-aware mode, + go get + with the -u flag now updates a smaller set of modules that is + more consistent with the set of packages updated by go get -u in GOPATH mode. go get -u continues to update the modules and packages named on the command line, but additionally updates only @@ -272,10 +267,7 @@ go env -w GOSUMDB=off upgrades only non-test dependencies, as in GOPATH mode. It now also accepts the -t flag, which (as in GOPATH mode) causes go get to include the packages imported - by tests of the packages named on the command line. If - the -t flag is set, the packages imported by tests will be - updated (if the -u flag is set), downloaded, and built (unless - the -d flag is set) along with the usual non-test packages. + by tests of the packages named on the command line.

@@ -284,8 +276,6 @@ go env -w GOSUMDB=off suffix indicates that the named module, or module containing the named package, should be updated to the highest patch release with the same major and minor versions as the version found in the build list. - If no such version is present in the build list, @patch is - equivalent to the existing @latest suffix.

Version validation

-- 2.50.0