<td><ahref="http://godoc.org/code.google.com/p/go.tools/cmd/cover/">cover</a></td>

<td><ahref="//godoc.org/code.google.com/p/go.tools/cmd/cover/">cover</a></td>

<td>&nbsp;&nbsp;&nbsp;&nbsp;</td>

<td>Cover is a program for creating and analyzing the coverage profiles

generated by<code>"go test -coverprofile"</code>.

<td><ahref="http://godoc.org/code.google.com/p/go.tools/cmd/godoc/">godoc</a></td>

<td><ahref="//godoc.org/code.google.com/p/go.tools/cmd/godoc/">godoc</a></td>

<td>&nbsp;&nbsp;&nbsp;&nbsp;</td>

<td>Godoc extracts and generates documentation for Go packages.</td>

<td><ahref="http://godoc.org/code.google.com/p/go.tools/cmd/vet/">vet</a></td>

<td><ahref="//godoc.org/code.google.com/p/go.tools/cmd/vet/">vet</a></td>

<td>&nbsp;&nbsp;&nbsp;&nbsp;</td>

<td>Vet examines Go source code and reports suspicious constructs, such as Printf

calls whose arguments do not align with the format string.</td>

A similar explanation is available as a

<ahref="http://www.youtube.com/watch?v=XCsL89YtqCs">screencast</a>.

<ahref="//www.youtube.com/watch?v=XCsL89YtqCs">screencast</a>.

this property to automatically fetch packages from remote repositories.

For instance, the examples described in this document are also kept in a

Mercurial repository hosted at Google Code,

<code><ahref="http://code.google.com/p/go.example">code.google.com/p/go.example</a></code>.

<code><ahref="//code.google.com/p/go.example">code.google.com/p/go.example</a></code>.

If you include the repository URL in the package's import path,

<code>go get</code> will fetch, build, and install it automatically:

This convention is the easiest way to make your Go packages available for

others to use.

The<ahref="http://code.google.com/p/go-wiki/wiki/Projects">Go Wiki</a>

and<ahref="http://godoc.org/">godoc.org</a>

The<ahref="//code.google.com/p/go-wiki/wiki/Projects">Go Wiki</a>

and<ahref="//godoc.org/">godoc.org</a>

provide lists of external Go projects.

Subscribe to the

<ahref="http://groups.google.com/group/golang-announce">golang-announce</a>

<ahref="//groups.google.com/group/golang-announce">golang-announce</a>

mailing list to be notified when a new stable version of Go is released.

Take<ahref="http://tour.golang.org/">A Tour of Go</a> to learn the language

Take<ahref="//tour.golang.org/">A Tour of Go</a> to learn the language

proper.

The official mailing list for discussion of the Go language is

<ahref="http://groups.google.com/group/golang-nuts">Go Nuts</a>.

<ahref="//groups.google.com/group/golang-nuts">Go Nuts</a>.

Report bugs using the

<ahref="http://code.google.com/p/go/issues/list">Go issue tracker</a>.

<ahref="//code.google.com/p/go/issues/list">Go issue tracker</a>.

Go is an open source project developed by a team at

<ahref="http://google.com/">Google</a> and many

<ahref="//google.com/">Google</a> and many

<ahref="/CONTRIBUTORS">contributors</a> from the open source community.

Go is distributed under a<ahref="/LICENSE">BSD-style license</a>.

<h3id="announce"><ahref="http://groups.google.com/group/golang-announce">Announcements Mailing List</a></h3>

<h3id="announce"><ahref="//groups.google.com/group/golang-announce">Announcements Mailing List</a></h3>

A low traffic mailing list for important announcements, such as new releases.

We encourage all Go users to subscribe to

<ahref="http://groups.google.com/group/golang-announce">golang-announce</a>.

<ahref="//groups.google.com/group/golang-announce">golang-announce</a>.

<p>A mailing list that receives a message summarizing each checkin to the Go repository.</p>

<h3id="golang-bugs"><ahref="https://groups.google.com/group/golang-bugs">Bugs Mailing List</a></h3>

<p>A mailing list that receives each update to the Go<ahref="http://golang.org/issue">issue tracker</a>.</p>

<p>A mailing list that receives each update to the Go<ahref="//golang.org/issue">issue tracker</a>.</p>

<h3id="build_status"><ahref="http://build.golang.org/">Build Status</a></h3>

<h3id="build_status"><ahref="//build.golang.org/">Build Status</a></h3>

<p>View the status of Go builds across the supported operating

systems and architectures.</p>

<p>This page summarizes the changes between official stable releases of Go.

The<ahref="http://code.google.com/p/go/source/list">Mercurial change log</a>

The<ahref="//code.google.com/p/go/source/list">Mercurial change log</a>

has the full details.</p>

<p>To update to a specific release, use:</p>

go1.2.1 (released 2014/03/02) includes bug fixes to the<code>runtime</code>,<code>net</code>, and<code>database/sql</code> packages.

See the<ahref="https://code.google.com/p/go/source/list?name=release-branch.go1.2&r=7ada9e760ce34e78aee5b476c9621556d0fa5d31">change history</a> for details.

See the<ahref="//code.google.com/p/go/source/list?name=release-branch.go1.2&r=7ada9e760ce34e78aee5b476c9621556d0fa5d31">change history</a> for details.

go1.2.2 (released 2014/05/05) includes a

<ahref="https://code.google.com/p/go/source/detail?r=bda3619e7a2c&repo=tools">security fix</a>

<ahref="//code.google.com/p/go/source/detail?r=bda3619e7a2c&repo=tools">security fix</a>

that affects the tour binary included in the binary distributions (thanks to Guillaume T).

go1.1.1 (released 2013/06/13) includes several compiler and runtime bug fixes.

See the<ahref="https://code.google.com/p/go/source/list?name=release-branch.go1.1&r=43c4a41d24382a56a90e924800c681e435d9e399">change history</a> for details.

See the<ahref="//code.google.com/p/go/source/list?name=release-branch.go1.1&r=43c4a41d24382a56a90e924800c681e435d9e399">change history</a> for details.

go1.1.2 (released 2013/08/13) includes fixes to the<code>gc</code> compiler

and<code>cgo</code>, and the<code>bufio</code>,<code>runtime</code>,

<code>syscall</code>, and<code>time</code> packages.

See the<ahref="https://code.google.com/p/go/source/list?name=release-branch.go1.1&r=a6a9792f94acd4ff686b2bc57383d163608b91cf">change history</a> for details.

See the<ahref="//code.google.com/p/go/source/list?name=release-branch.go1.1&r=a6a9792f94acd4ff686b2bc57383d163608b91cf">change history</a> for details.

If you use package syscall's<code>Getrlimit</code> and<code>Setrlimit</code>

functions under Linux on the ARM or 386 architectures, please note change

<ahref="http://golang.org/change/55ac276af5a7">55ac276af5a7</a>

that fixes<ahref="http://golang.org/issue/5949">issue 5949</a>.

<ahref="//golang.org/change/55ac276af5a7">55ac276af5a7</a>

that fixes<ahref="//golang.org/issue/5949">issue 5949</a>.

<h2id="go1">go1 (released 2012/03/28)</h2>

go1.0.1 (released 2012/04/25) was issued to

<ahref="https://code.google.com/p/go/source/detail?r=a890477d3dfb">fix</a> an

<ahref="https://code.google.com/p/go/issues/detail?id=3545">escape analysis

bug</a>that can lead to memory corruption.

<ahref="//golang.org/change/a890477d3dfb">fix</a> an

<ahref="//golang.org/issue/3545">escape analysis bug</a>

that can lead to memory corruption.

It also includes several minor code and documentation fixes.

go1.0.2 (released 2012/06/13) was issued to fix two bugs in the implementation

of maps using struct or array keys:

<ahref="http://code.google.com/p/go/issues/detail?id=3695">issue 3695</a> and

<ahref="http://code.google.com/p/go/issues/detail?id=3573">issue 3573</a>.

<ahref="//golang.org/issue/3695">issue 3695</a> and

<ahref="//golang.org/issue/3573">issue 3573</a>.

It also includes many minor code and documentation fixes.

See the<ahref="http://code.google.com/p/go/source/list?name=release-branch.go1">go1 release branch history</a> for the complete list of changes.

See the<ahref="//code.google.com/p/go/source/list?name=release-branch.go1">go1 release branch history</a> for the complete list of changes.

<h2id="r60">r60 (released 2011/09/07)</h2>

For a more detailed summary, see the

<ahref="weekly.html#2011-08-17">weekly release notes</a>.

For complete information, see the

<ahref="http://code.google.com/p/go/source/list?r=release-branch.r60">Mercurial change list</a>.

<ahref="//code.google.com/p/go/source/list?r=release-branch.r60">Mercurial change list</a>.

<h3id="r60.lang">Language</h3>

r60.1 includes a

<ahref="http://code.google.com/p/go/source/detail?r=1824581bf62d">linker

<ahref="//golang.org/change/1824581bf62d">linker

fix</a>, a pair of

<ahref="http://code.google.com/p/go/source/detail?r=9ef4429c2c64">goplay</a>

<ahref="http://code.google.com/p/go/source/detail?r=d42ed8c3098e">fixes</a>,

<ahref="//golang.org/change/9ef4429c2c64">goplay</a>

<ahref="//golang.org/change/d42ed8c3098e">fixes</a>,

and a<code>json</code> package

<ahref="http://code.google.com/p/go/source/detail?r=d5e97874fe84">fix</a> and

<ahref="//golang.org/change/d5e97874fe84">fix</a> and

a new

<ahref="http://code.google.com/p/go/source/detail?r=4f0e6269213f">struct tag

<ahref="//golang.org/change/4f0e6269213f">struct tag

option</a>.

r60.2

<ahref="http://code.google.com/p/go/source/detail?r=ff19536042ac">fixes</a>

<ahref="//golang.org/change/ff19536042ac">fixes</a>

a memory leak involving maps.

r60.3 fixes a

<ahref="http://code.google.com/p/go/source/detail?r=01fa62f5e4e5">reflect bug</a>.

<ahref="//golang.org/change/01fa62f5e4e5">reflect bug</a>.

<h2id="r59">r59 (released 2011/08/01)</h2>

For a more detailed summary, see the

<ahref="weekly.html#2011-07-07">weekly release notes</a>.

For complete information, see the

<ahref="http://code.google.com/p/go/source/list?r=release-branch.r59">Mercurial change list</a>.

<ahref="//code.google.com/p/go/source/list?r=release-branch.r59">Mercurial change list</a>.

<h3id="r59.lang">Language</h3>

<code>goto</code>. In essence, a<code>goto</code> statement outside a block

cannot jump to a label inside that block. Your code may require changes if it

uses<code>goto</code>.

See<ahref="http://code.google.com/p/go/source/detail?r=dc6d3cf9279d">this

See<ahref="//golang.org/change/dc6d3cf9279d">this

changeset</a> for how the new rule affected the Go tree.

For a more detailed summary, see the

<ahref="weekly.html#2011-06-09">weekly release notes</a>.

For complete information, see the

<ahref="http://code.google.com/p/go/source/list?r=release-branch.r58">Mercurial change list</a>.

<ahref="//code.google.com/p/go/source/list?r=release-branch.r58">Mercurial change list</a>.

<h3id="r58.lang">Language</h3>

This release fixes a<ahref="http://code.google.com/p/go/source/detail?r=b720749486e1">use of uninitialized memory in programs that misuse<code>goto</code></a>.

This release fixes a<ahref="//golang.org/change/b720749486e1">use of uninitialized memory in programs that misuse<code>goto</code></a>.

<h3id="r58.pkg">Packages</h3>

<h3id="r58.minor">Minor revisions</h3>

<p>r58.1 adds

<ahref="http://code.google.com/p/go/source/detail?r=293c25943586">build</a> and

<ahref="http://code.google.com/p/go/source/detail?r=bf17e96b6582">runtime</a>

<ahref="//golang.org/change/293c25943586">build</a> and

<ahref="//golang.org/change/bf17e96b6582">runtime</a>

changes to make Go run on OS X 10.7 Lion.

For a more detailed summary, see the

<ahref="weekly.html#2011-04-27">weekly release notes</a>.

For complete information, see the

<ahref="http://code.google.com/p/go/source/list?r=release-branch.r57">Mercurial change list</a>.

<ahref="//code.google.com/p/go/source/list?r=release-branch.r57">Mercurial change list</a>.

<p>The new<ahref="/cmd/gofix">gofix</a> tool finds Go programs that use old APIs and rewrites them to use

Gofix can’t

handle all situations perfectly, so read and test the changes it makes before

committing them.

See<ahref="http://blog.golang.org/2011/04/introducing-gofix.html">the gofix blog post</a> for more

See<ahref="//blog.golang.org/2011/04/introducing-gofix.html">the gofix blog post</a> for more

information.</p>

<h3id="r57.lang">Language</h3>

<ahref="/pkg/http/#Client">Client</a> and<ahref="/pkg/http/#Transport">Transport</a>

abstractions that give more control over HTTP details such as headers sent

and redirections followed. These abstractions make it easy to implement

custom clients that add functionality such as<ahref="http://code.google.com/p/goauth2/source/browse/oauth/oauth.go">OAuth2</a>.

custom clients that add functionality such as<ahref="//code.google.com/p/goauth2/source/browse/oauth/oauth.go">OAuth2</a>.

For servers,<ahref="/pkg/http/#ResponseWriter">ResponseWriter</a>

has dropped its non-essential methods.

The Hijack and Flush methods are no longer required;

Instead of a type switch on a Value<code>v</code>, switch on<code>v.Kind()</code>.

Typeof and NewValue are now called<ahref="/pkg/reflect/#Type.TypeOf">TypeOf</a> and<ahref="/pkg/reflect/#Value.ValueOf">ValueOf</a>

To create a writable Value, use<code>New(t).Elem()</code> instead of<code>Zero(t)</code>.

See<ahref="http://code.google.com/p/go/source/detail?r=843855f3c026">the change description</a>

See<ahref="//golang.org/change/843855f3c026">the change description</a>

for the full details.

The new API allows a more efficient implementation of Value

that avoids many of the allocations required by the previous API.

<h3id="r57.minor">Minor revisions</h3>

<p>r57.1 fixes a<ahref="http://code.google.com/p/go/source/detail?r=ff2bc62726e7145eb2ecc1e0f076998e4a8f86f0">nil pointer dereference in http.FormFile</a>.</p>

<p>r57.2 fixes a<ahref="http://code.google.com/p/go/source/detail?r=063b0ff67d8277df03c956208abc068076818dae">use of uninitialized memory in programs that misuse<code>goto</code></a>.</p>

<p>r57.1 fixes a<ahref="//golang.org/change/ff2bc62726e7145eb2ecc1e0f076998e4a8f86f0">nil pointer dereference in http.FormFile</a>.</p>

<p>r57.2 fixes a<ahref="//golang.org/change/063b0ff67d8277df03c956208abc068076818dae">use of uninitialized memory in programs that misuse<code>goto</code></a>.</p>

<h2id="r56">r56 (released 2011/03/16)</h2>

<p>This page summarizes the changes between tagged weekly snapshots of Go.

Such snapshots are no longer created. This page remains as a historical reference only.</p>

<p>For recent information, see the<ahref="http://code.google.com/p/go/source/list">Mercurial change log</a> and<ahref="http://groups.google.com/group/golang-dev/">development mailing list</a>.</p>

<p>For recent information, see the<ahref="//code.google.com/p/go/source/list">Mercurial change log</a> and<ahref="//groups.google.com/group/golang-dev/">development mailing list</a>.</p>

<h2id="2012-03-27">2012-03-27 (<ahref="release.html#go1">Go 1</a>)</h2>

<imgclass="gopher"src="/doc/gopher/doc.png"/>

<h3id="go_tour"><ahref="http://tour.golang.org/">A Tour of Go</a></h3>

<h3id="go_tour"><ahref="//tour.golang.org/">A Tour of Go</a></h3>

An interactive introduction to Go in three sections.

The first section covers basic syntax and data structures; the second discusses

methods and interfaces; and the third introduces Go's concurrency primitives.

Each section concludes with a few exercises so you can practice what you've

learned. You can<ahref="http://tour.golang.org/">take the tour online</a> or

<ahref="http://code.google.com/p/go-tour/">install it locally</a>.

learned. You can<ahref="//tour.golang.org/">take the tour online</a> or

<ahref="//code.google.com/p/go-tour/">install it locally</a>.

<h3id="code"><ahref="code.html">How to write Go code</a></h3>

Also available as a

<ahref="http://www.youtube.com/watch?v=XCsL89YtqCs">screencast</a>, this doc

<ahref="//www.youtube.com/watch?v=XCsL89YtqCs">screencast</a>, this doc

explains how to use the<ahref="/cmd/go/">go command</a> to fetch, build, and

install packages, commands, and run tests.

<h2id="articles">Articles</h2>

<h3id="blog"><ahref="http://blog.golang.org/">The Go Blog</a></h3>

<h3id="blog"><ahref="//blog.golang.org/">The Go Blog</a></h3>

<p>The official blog of the Go project, featuring news and in-depth articles by

the Go team and guests.</p>

demonstrate these.

<h3id="go_code_that_grows"><ahref="http://vimeo.com/53221560">Code that grows with grace</a></h3>

<h3id="go_code_that_grows"><ahref="//vimeo.com/53221560">Code that grows with grace</a></h3>

One of Go's key design goals is code adaptability; that it should be easy to take a simple design and build upon it in a clean and natural way. In this talk Andrew Gerrand describes a simple "chat roulette" server that matches pairs of incoming TCP connections, and then use Go's concurrency mechanisms, interfaces, and standard library to extend it with a web interface and other features. While the function of the program changes dramatically, Go's flexibility preserves the original design as it grows.

<h3id="go_concurrency_patterns"><ahref="http://www.youtube.com/watch?v=f6kdp27TYZs">Go Concurrency Patterns</a></h3>

<h3id="go_concurrency_patterns"><ahref="//www.youtube.com/watch?v=f6kdp27TYZs">Go Concurrency Patterns</a></h3>

Concurrency is the key to designing high performance network services. Go's concurrency primitives (goroutines and channels) provide a simple and efficient means of expressing concurrent execution. In this talk we see how tricky concurrency problems can be solved gracefully with simple Go code.

<h3id="advanced_go_concurrency_patterns"><ahref="http://www.youtube.com/watch?v=QDDwwePbDtw">Advanced Go Concurrency Patterns</a></h3>

<h3id="advanced_go_concurrency_patterns"><ahref="//www.youtube.com/watch?v=QDDwwePbDtw">Advanced Go Concurrency Patterns</a></h3>

This talk expands on the<i>Go Concurrency Patterns</i> talk to dive deeper into Go's concurrency primitives.