aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRuss Cox <rsc@golang.org>2012-03-01 18:17:28 -0500
committerRuss Cox <rsc@golang.org>2012-03-01 18:17:28 -0500
commit9996f7f17adca8af6b34c4df6870e88d289a65a9 (patch)
tree0aa2ad1048dfc9b918cb0bec6cf4525cc137367d
parente8c970e5f7d5fa720a38da00a31870fc0b1c2b0f (diff)
downloadgo-9996f7f17adca8af6b34c4df6870e88d289a65a9.tar.gz
go-9996f7f17adca8af6b34c4df6870e88d289a65a9.zip
doc: describe API changes to go/build
R=golang-dev, gri, r CC=golang-dev https://golang.org/cl/5711059
-rw-r--r--doc/go1.html16
-rw-r--r--doc/go1.tmpl16
2 files changed, 32 insertions, 0 deletions
diff --git a/doc/go1.html b/doc/go1.html
index 5837104893..0ec097499a 100644
--- a/doc/go1.html
+++ b/doc/go1.html
@@ -1284,6 +1284,22 @@ accepts a function argument instead.
</p>
<p>
+In package <a href="/pkg/go/build/"><code>go/build</code></a>, the API
+has been nearly completely replaced.
+The package still computes Go package information
+but it does not run the build: the <code>Cmd</code> and <code>Script</code>
+types are gone.
+(To build code, use the new
+<a href="/cmd/go/"><code>go</code></a> command instead.)
+The <code>DirInfo</code> type is now named
+<a href="/pkg/go/build/#Package"><code>Package</code></a>.
+<code>FindTree</code> and <code>ScanDir</code> are replaced by
+<a href="/pkg/go/build/#Import"><code>Import</code></a>
+and
+<a href="/pkg/go/build/#ImportDir"><code>ImportDir</code></a>.
+</p>
+
+<p>
<em>Updating</em>:
Code that uses packages in <code>go</code> will have to be updated by hand; the
compiler will reject incorrect uses. Templates used in conjunction with any of the
diff --git a/doc/go1.tmpl b/doc/go1.tmpl
index ccbda8d157..c1dd9a8f06 100644
--- a/doc/go1.tmpl
+++ b/doc/go1.tmpl
@@ -1187,6 +1187,22 @@ accepts a function argument instead.
</p>
<p>
+In package <a href="/pkg/go/build/"><code>go/build</code></a>, the API
+has been nearly completely replaced.
+The package still computes Go package information
+but it does not run the build: the <code>Cmd</code> and <code>Script</code>
+types are gone.
+(To build code, use the new
+<a href="/cmd/go/"><code>go</code></a> command instead.)
+The <code>DirInfo</code> type is now named
+<a href="/pkg/go/build/#Package"><code>Package</code></a>.
+<code>FindTree</code> and <code>ScanDir</code> are replaced by
+<a href="/pkg/go/build/#Import"><code>Import</code></a>
+and
+<a href="/pkg/go/build/#ImportDir"><code>ImportDir</code></a>.
+</p>
+
+<p>
<em>Updating</em>:
Code that uses packages in <code>go</code> will have to be updated by hand; the
compiler will reject incorrect uses. Templates used in conjunction with any of the