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>
diff --git a/doc/go1.11.html b/doc/go1.11.html
index a1249db..89649f3 100644
--- a/doc/go1.11.html
+++ b/doc/go1.11.html
@@ -167,7 +167,18 @@
<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 @@
<!-- 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 -->
