]> Cypherpunks repositories - gostls13.git/commitdiff
cmd/go: fix unnecessary plural
authorKevin Burke <kev@inburke.com>
Wed, 1 Aug 2018 04:43:07 +0000 (21:43 -0700)
committerKevin Burke <kev@inburke.com>
Sat, 4 Aug 2018 16:37:47 +0000 (16:37 +0000)
"expanded imports paths" should read "expanded import paths." Run
mkalldocs.sh to pick up other changes which were not committed to
alldocs.go.

Change-Id: Iaa61e022d65f9464e8ff93a92cfba27dadf679cf
Reviewed-on: https://go-review.googlesource.com/127157
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
src/cmd/go/alldocs.go
src/cmd/go/internal/list/list.go

index d6eebab3bf6cb78d09dc97825154807371c4b6e7..a4a66efcf50134f75057aae360cd27544958aff4 100644 (file)
 // path to the vendor directory (for example, "d/vendor/p" instead of "p"),
 // so that the ImportPath uniquely identifies a given copy of a package.
 // The Imports, Deps, TestImports, and XTestImports lists also contain these
-// expanded imports paths. See golang.org/s/go15vendor for more about vendoring.
+// expanded import paths. See golang.org/s/go15vendor for more about vendoring.
 //
 // The error information, if any, is
 //
 //
 // The go command by default downloads modules from version control systems
 // directly, just as 'go get' always has. The GOPROXY environment variable allows
-// further control over the download source. GOPROXY being unset, the empty string,
-// or the string "direct" corresponds to the default direct connection to version
+// further control over the download source. If GOPROXY is unset, is the empty string,
+// or is the string "direct", downloads use the default direct connection to version
 // control systems. Setting GOPROXY to "off" disallows downloading modules from
-// any source. Otherwise, if GOPROXY is expected to be the URL of a module proxy,
+// any source. Otherwise, GOPROXY is expected to be the URL of a module proxy,
 // in which case the go command will fetch all modules from that proxy.
 // No matter the source of the modules, downloaded modules must match existing
 // entries in go.sum (see 'go help modules' for discussion of verification).
 // and understanding modules and go.mod files. See 'go help mod'.
 //
 // The -mod build flag provides additional control over updating and use of go.mod.
-// If invoked with -mod=readonly, the go command disables its automatic updates
-// of go.mod as described above and fails if any changes are needed. This setting
-// is most useful to check that go.mod does not need any updates, such as in a
-// continuous integration and testing system.
+//
+// If invoked with -mod=readonly, the go command is disallowed from the implicit
+// automatic updating of go.mod described above. Instead, it fails when any changes
+// to go.mod are needed. This setting is most useful to check that go.mod does
+// not need updates, such as in a continuous integration and testing system.
+// The "go get" command remains permitted to update go.mod even with -mod=readonly,
+// and the "go mod" commands do not take the -mod flag (or any other build flags).
+//
 // If invoked with -mod=vendor, the go command assumes that the vendor
 // directory holds the correct copies of dependencies and ignores
 // the dependency descriptions in go.mod.
index 780916312bacac373ebd8382d19a94afcf7ef628..524ab99812997397ea81d5ad7dbc0a43623018de 100644 (file)
@@ -107,7 +107,7 @@ Packages stored in vendor directories report an ImportPath that includes the
 path to the vendor directory (for example, "d/vendor/p" instead of "p"),
 so that the ImportPath uniquely identifies a given copy of a package.
 The Imports, Deps, TestImports, and XTestImports lists also contain these
-expanded imports paths. See golang.org/s/go15vendor for more about vendoring.
+expanded import paths. See golang.org/s/go15vendor for more about vendoring.
 
 The error information, if any, is