From: Bryan C. Mills <bcmills@google.com>
Date: Tue, 9 Oct 2018 21:14:34 +0000 (-0400)
Subject: cmd/go/internal/mvs: document that BuildList is sorted
X-Git-Tag: go1.12beta1~626
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=44c72957d6ea071bf3bef7460c88319b5c283b8b;p=gostls13.git

cmd/go/internal/mvs: document that BuildList is sorted

Updates #28102

Change-Id: Iee1ff64c7720108d6d26bfbff60ea51877093960
Reviewed-on: https://go-review.googlesource.com/c/140862
Run-TryBot: Bryan C. Mills <bcmills@google.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Russ Cox <rsc@golang.org>
---

diff --git a/src/cmd/go/internal/mvs/mvs.go b/src/cmd/go/internal/mvs/mvs.go
index 8ec9162dab..aa109693f3 100644
--- a/src/cmd/go/internal/mvs/mvs.go
+++ b/src/cmd/go/internal/mvs/mvs.go
@@ -68,6 +68,7 @@ func (e *MissingModuleError) Error() string {
 }
 
 // BuildList returns the build list for the target module.
+// The first element is the target itself, with the remainder of the list sorted by path.
 func BuildList(target module.Version, reqs Reqs) ([]module.Version, error) {
 	return buildList(target, reqs, nil)
 }