2014-12-09 22:06:47 -07:00
# The Go Programming Language
2014-12-10 15:44:54 -07:00
Go is an open source programming language that makes it easy to build simple,
reliable, and efficient software.
2014-12-09 22:06:47 -07:00
![Gopher image ](doc/gopher/fiveyears.jpg )
2009-11-08 10:57:37 -07:00
For documentation about how to install and use Go,
2014-12-10 15:44:54 -07:00
visit https://golang.org/ or load doc/install-source.html
2013-11-20 14:47:37 -07:00
in your web browser.
2009-11-08 10:57:37 -07:00
2014-12-09 22:06:47 -07:00
Our canonical Git repository is located at https://go.googlesource.com/go.
2015-02-18 19:34:44 -07:00
There is a mirror of the repository at https://github.com/golang/go.
2014-12-09 22:06:47 -07:00
Go is the work of hundreds of contributors. We appreciate your help!
To contribute, please read the contribution guidelines:
2014-12-10 15:44:54 -07:00
https://golang.org/doc/contribute.html
2009-11-08 10:57:37 -07:00
2015-10-02 11:55:27 -06:00
##### Note that we do not accept pull requests and that we use the issue tracker for bug reports and proposals only. Please ask questions on https://forum.golangbridge.org or https://groups.google.com/forum/#!forum/golang-nuts.
2015-01-08 11:35:44 -07:00
2009-11-08 10:57:37 -07:00
Unless otherwise noted, the Go source files are distributed
under the BSD-style license found in the LICENSE file.
2010-07-29 22:00:59 -06:00
--
2014-12-09 22:06:47 -07:00
## Binary Distribution Notes
2010-07-29 22:00:59 -06:00
2010-08-24 18:00:50 -06:00
If you have just untarred a binary Go distribution, you need to set
the environment variable $GOROOT to the full path of the go
2014-12-10 15:44:54 -07:00
directory (the one containing this file). You can omit the
2010-08-24 18:00:50 -06:00
variable if you unpack it into /usr/local/go, or if you rebuild
2014-12-10 15:44:54 -07:00
from sources by running all.bash (see doc/install-source.html).
2010-08-24 18:00:50 -06:00
You should also add the Go binary directory $GOROOT/bin
to your shell's path.
2010-07-29 22:00:59 -06:00
2010-08-24 18:00:50 -06:00
For example, if you extracted the tar file into $HOME/go, you might
put the following in your .profile:
2010-07-29 22:00:59 -06:00
2014-12-09 22:06:47 -07:00
export GOROOT=$HOME/go
export PATH=$PATH:$GOROOT/bin
See https://golang.org/doc/install or doc/install.html for more details.