1
0
mirror of https://github.com/golang/go synced 2024-11-22 04:14:42 -07:00
The Go programming language
Go to file
Russ Cox ebe1664d27 go/build: replace FindTree, ScanDir, Tree, DirInfo with Import, Package
This is an API change, but one I have been promising would
happen when it was clear what the go command needed.

This is basically a complete replacement of what used to be here.

build.Tree is gone.

build.DirInfo is expanded and now called build.Package.

build.FindTree is now build.Import(package, srcDir, build.FindOnly).
The returned *Package contains information that FindTree returned,
but applicable only to a single package.

build.ScanDir is now build.ImportDir.

build.FindTree+build.ScanDir is now build.Import.

The new Import API allows specifying the source directory,
in order to resolve local imports (import "./foo") and also allows
scanning of packages outside of $GOPATH.  They will come back
with less information in the Package, but they will still work.

The old go/build API exposed both too much and too little.
This API is much closer to what the go command needs,
and it works well enough in the other places where it is
used.  Path is gone, so it can no longer be misused.  (Fixes issue 2749.)

This CL updates clients of go/build other than the go command.
The go command changes are in a separate CL, to be submitted
at the same time.

R=golang-dev, r, alex.brainman, adg
CC=golang-dev
https://golang.org/cl/5713043
2012-03-01 12:12:09 -05:00
doc doc: update link to self-hosted "The Laws of Reflection" article 2012-03-01 14:54:35 +08:00
include build: remove unnecessary pragmas 2012-02-06 12:45:23 -05:00
lib godoc: add Examples link to top-level index 2012-02-28 16:05:12 +11:00
misc misc/dist: implement binary distribution scripts in go 2012-03-01 15:49:37 +11:00
src go/build: replace FindTree, ScanDir, Tree, DirInfo with Import, Package 2012-03-01 12:12:09 -05:00
test test: add test of calling recover in a varargs function 2012-03-01 08:24:03 -08:00
.hgignore build: remove old version*.go files from hgignore 2012-02-20 02:49:58 -08:00
.hgtags tag weekly.2012-02-22 2012-02-23 16:59:11 +11:00
AUTHORS A+C: add Yissakhar Z. Beck (Individual CLA) 2012-02-28 07:40:44 +11:00
CONTRIBUTORS A+C: add Yissakhar Z. Beck (Individual CLA) 2012-02-28 07:40:44 +11:00
favicon.ico add a favicon plus a couple of hi-res versions of gordon 2009-10-26 10:13:07 -07:00
LICENSE LICENSE: separate, change PATENTS text 2010-12-06 16:31:59 -05:00
PATENTS LICENSE: separate, change PATENTS text 2010-12-06 16:31:59 -05:00
README build: update, streamline documentation for new $GOBIN 2010-08-24 20:00:50 -04:00
robots.txt godoc: serve robots.txt raw 2011-02-19 05:46:20 +11:00

This is the source code repository for the Go programming language.  

For documentation about how to install and use Go,
visit http://golang.org/ or load doc/install.html in your web browser.

After installing Go, you can view a nicely formatted
doc/install.html by running godoc --http=:6060
and then visiting http://localhost:6060/doc/install.html.

Unless otherwise noted, the Go source files are distributed
under the BSD-style license found in the LICENSE file.

--

Binary Distribution Notes

If you have just untarred a binary Go distribution, you need to set
the environment variable $GOROOT to the full path of the go
directory (the one containing this README).  You can omit the
variable if you unpack it into /usr/local/go, or if you rebuild
from sources by running all.bash (see doc/install.html).
You should also add the Go binary directory $GOROOT/bin
to your shell's path.

For example, if you extracted the tar file into $HOME/go, you might
put the following in your .profile:

    export GOROOT=$HOME/go
    export PATH=$PATH:$GOROOT/bin

See doc/install.html for more details.