From 751cae8855f34116b0596d15cd499bb07b4e6747 Mon Sep 17 00:00:00 2001 From: Russ Cox Date: Thu, 9 Jun 2022 08:51:11 -0400 Subject: [PATCH] cmd/go/internal/modload: fix doc comment Change-Id: Ib7f47c7fc2fa5db3adbe51612b1e7a9bb49647b5 Reviewed-on: https://go-review.googlesource.com/c/go/+/411105 Reviewed-by: Ian Lance Taylor Run-TryBot: Russ Cox TryBot-Result: Gopher Robot --- src/cmd/go/internal/modload/query.go | 31 ++++++++++++++-------------- 1 file changed, 15 insertions(+), 16 deletions(-) diff --git a/src/cmd/go/internal/modload/query.go b/src/cmd/go/internal/modload/query.go index 69e5fbd93b..ae5304f87e 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