diff --git a/src/cmd/go/internal/modload/query.go b/src/cmd/go/internal/modload/query.go index 69e5fbd93bb..ae5304f87eb 100644 --- a/src/cmd/go/internal/modload/query.go +++ b/src/cmd/go/internal/modload/query.go @@ -32,29 +32,28 @@ import ( // The module must be a complete module path. // The version must take one of the following forms: // -// - the literal string "latest", denoting the latest available, allowed +// - the literal string "latest", denoting the latest available, allowed +// tagged version, with non-prereleases preferred over prereleases. +// If there are no tagged versions in the repo, latest returns the most +// recent commit. // -// tagged version, with non-prereleases preferred over prereleases. -// If there are no tagged versions in the repo, latest returns the most -// recent commit. +// - the literal string "upgrade", equivalent to "latest" except that if +// current is a newer version, current will be returned (see below). // -// - the literal string "upgrade", equivalent to "latest" except that if +// - the literal string "patch", denoting the latest available tagged version +// with the same major and minor number as current (see below). // -// current is a newer version, current will be returned (see below). +// - v1, denoting the latest available tagged version v1.x.x. // -// - the literal string "patch", denoting the latest available tagged version +// - v1.2, denoting the latest available tagged version v1.2.x. // -// with the same major and minor number as current (see below). +// - v1.2.3, a semantic version string denoting that tagged version. // -// - v1, denoting the latest available tagged version v1.x.x. -// - v1.2, denoting the latest available tagged version v1.2.x. -// - v1.2.3, a semantic version string denoting that tagged version. -// - v1.2.3, >=v1.2.3, +// - v1.2.3, >=v1.2.3, +// denoting the version closest to the target and satisfying the given operator, +// with non-prereleases preferred over prereleases. // -// denoting the version closest to the target and satisfying the given operator, -// with non-prereleases preferred over prereleases. -// -// - a repository commit identifier or tag, denoting that commit. +// - a repository commit identifier or tag, denoting that commit. // // current denotes the currently-selected version of the module; it may be // "none" if no version is currently selected, or "" if the currently-selected