diff options
author | Alan Donovan <adonovan@google.com> | 2018-08-16 16:31:45 -0400 |
---|---|---|
committer | Andrew Bonventre <andybons@golang.org> | 2018-08-17 18:38:27 +0000 |
commit | 08d10f9af1429d19633722e36f7bfeda6c000aa5 (patch) | |
tree | 8ff12a586e66ee28f82857d6efc150a41e659617 | |
parent | c81d216d844f165b729fa3dbb0c3d834eb4268a8 (diff) | |
download | go-08d10f9af1429d19633722e36f7bfeda6c000aa5.tar.gz go-08d10f9af1429d19633722e36f7bfeda6c000aa5.zip |
doc: describe golang.org/x/go/packages in go1.11 release notes
Also, rename an HTML element ID to avoid duplicate.
Fixes golang/go#27038
Change-Id: Icc064a1cc86ddc794fc085d98b4cde3effff8ad0
Reviewed-on: https://go-review.googlesource.com/129635
Reviewed-by: Andrew Bonventre <andybons@golang.org>
Reviewed-by: Ian Cottrell <iancottrell@google.com>
-rw-r--r-- | doc/go1.11.html | 15 |
1 files changed, 13 insertions, 2 deletions
diff --git a/doc/go1.11.html b/doc/go1.11.html index a1249db475..89649f34c0 100644 --- a/doc/go1.11.html +++ b/doc/go1.11.html @@ -167,7 +167,18 @@ Do not send CLs removing the interior tags from such phrases. <h3 id="gopackages">Package loading</h3> <p> - TODO: Note about go/build versus golang.org/x/tools/go/packages. + The new package + <a href="https://godoc.org/golang.org/x/tools/go/packages"><code>golang.org/x/tools/go/packages</code></a> + provides a simple API for locating and loading packages of Go source code. + Although not yet part of the standard library, for many tasks it + effectively replaces the <a href="/pkg/go/build"><code>go/build</code></a> + package, whose API is unable to fully support modules. + Because it runs an external query command such as + <a href="/cmd/go/#hdr-List_packages"><code>go list</code></a> + to obtain information about Go packages, it enables the construction of + analysis tools that work equally well with alternative build systems + such as <a href="https://bazel.build">Bazel</a> + and <a href="https://buckbuild.com">Buck</a>. </p> <h3 id="gocache">Build cache requirement</h3> @@ -793,7 +804,7 @@ for k := range m { <!-- CL 101715 was reverted --> -<dl id="runtime"><dt><a href="/pkg/runtime/">runtime</a></dt> +<dl id="runtime-again"><dt><a href="/pkg/runtime/">runtime</a></dt> <dd> <p><!-- CL 70993 --> |