blob: 281deecdfbdf1ce4e02283a878de29becad2a5b5 [file] [log] [blame] [view]
Andrew Gerrand495e02d2014-12-10 16:06:47 +11001# The Go Programming Language
2
Andrew Gerrand69f24cf2014-12-11 09:44:54 +11003Go is an open source programming language that makes it easy to build simple,
4reliable, and efficient software.
5
Andrew Gerrand495e02d2014-12-10 16:06:47 +11006![Gopher image](doc/gopher/fiveyears.jpg)
7
8For documentation about how to install and use Go,
Andrew Gerrand69f24cf2014-12-11 09:44:54 +11009visit https://golang.org/ or load doc/install-source.html
Andrew Gerrand495e02d2014-12-10 16:06:47 +110010in your web browser.
11
12Our canonical Git repository is located at https://go.googlesource.com/go.
Ryan Seysac452342015-02-18 21:34:44 -050013There is a mirror of the repository at https://github.com/golang/go.
Andrew Gerrand495e02d2014-12-10 16:06:47 +110014
Andrew Gerrand495e02d2014-12-10 16:06:47 +110015Go is the work of hundreds of contributors. We appreciate your help!
16
17To contribute, please read the contribution guidelines:
Andrew Gerrand69f24cf2014-12-11 09:44:54 +110018 https://golang.org/doc/contribute.html
Andrew Gerrand495e02d2014-12-10 16:06:47 +110019
Robert Griesemer4c2a4002015-10-02 10:55:27 -070020##### 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.
Robert Griesemerf21ee1e2015-01-08 10:35:44 -080021
Andrew Gerrand495e02d2014-12-10 16:06:47 +110022Unless otherwise noted, the Go source files are distributed
23under the BSD-style license found in the LICENSE file.
24
25--
26
27## Binary Distribution Notes
28
29If you have just untarred a binary Go distribution, you need to set
30the environment variable $GOROOT to the full path of the go
Andrew Gerrand69f24cf2014-12-11 09:44:54 +110031directory (the one containing this file). You can omit the
Andrew Gerrand495e02d2014-12-10 16:06:47 +110032variable if you unpack it into /usr/local/go, or if you rebuild
Andrew Gerrand69f24cf2014-12-11 09:44:54 +110033from sources by running all.bash (see doc/install-source.html).
Andrew Gerrand495e02d2014-12-10 16:06:47 +110034You should also add the Go binary directory $GOROOT/bin
35to your shell's path.
36
37For example, if you extracted the tar file into $HOME/go, you might
38put the following in your .profile:
39
40 export GOROOT=$HOME/go
41 export PATH=$PATH:$GOROOT/bin
42
43See https://golang.org/doc/install or doc/install.html for more details.