doc/docs.html | 45 ++++++++++++++++++++++++++++++++++++++++++--- src/cmd/cgo/doc.go | 3 +++ src/cmd/godoc/doc.go | 3 +++ src/pkg/gob/doc.go | 3 +++ src/pkg/json/encode.go | 3 +++ src/pkg/reflect/type.go | 3 +++ diff --git a/doc/docs.html b/doc/docs.html index 9fd3dcebedb8072c287b8f6fa876ad4247f12228..ce833fdd1a09416e16f45ce4ae9612c9ce3f6d3a 100644 --- a/doc/docs.html +++ b/doc/docs.html @@ -29,9 +29,9 @@ Slides from a 3-day course about the Go programming language. A more thorough introduction than the tutorial.

Effective Go

@@ -62,11 +62,50 @@

Codewalks

Guided tours of Go programs.

+

Go for C++ Programmers

An introduction to Go for C++ programmers.

+ +

Go Articles

+ +

+Notable articles from the Go Blog. +

+ +

Language

+ + + +

Packages

+ + + +

Tools

+ +

Non-English Documentation

diff --git a/src/cmd/cgo/doc.go b/src/cmd/cgo/doc.go index 63413825af59dfae9ddf3b907fccce9f4f4c01fc..a4219867c7ab2e29f6df33ad613f84995a858992 100644 --- a/src/cmd/cgo/doc.go +++ b/src/cmd/cgo/doc.go @@ -92,5 +92,8 @@ process of using cgo. See $GOROOT/misc/cgo/stdio and $GOROOT/misc/cgo/gmp for examples. Cgo does not yet work with gccgo. + +See "C? Go? Cgo!" for an introduction to using cgo: +http://blog.golang.org/2011/03/c-go-cgo.html */ package documentation diff --git a/src/cmd/godoc/doc.go b/src/cmd/godoc/doc.go index dc98b0eca5c95b8fc9f3e23229cb3fff199401bd..088889d2a14a8563b3533b93f58302b198f1ddf6 100644 --- a/src/cmd/godoc/doc.go +++ b/src/cmd/godoc/doc.go @@ -126,5 +126,8 @@ one may run godoc as follows: godoc -http=:6060 -zip=go.zip -goroot=$HOME/go + +See "Godoc: documenting Go code" for how to write good comments for godoc: +http://blog.golang.org/2011/03/godoc-documenting-go-code.html */ package documentation diff --git a/src/pkg/gob/doc.go b/src/pkg/gob/doc.go index 35d882afb7ad290863e27378d4fbeea80d6cab93..a9284ced7f97743795b61760ee79e32bc4444652 100644 --- a/src/pkg/gob/doc.go +++ b/src/pkg/gob/doc.go @@ -221,6 +221,9 @@ (byteCount (-type id, encoding of a wireType)* (type id, encoding of a value))* where * signifies zero or more repetitions and the type id of a value must be predefined or be defined before the value in the stream. + +See "Gobs of data" for a design discussion of the gob wire format: +http://blog.golang.org/2011/03/gobs-of-data.html */ package gob diff --git a/src/pkg/json/encode.go b/src/pkg/json/encode.go index 3e593fec15fe532c2357e54b93dfaac92df32aa7..0e6529c6bbe57e34a35206aea82f512686dd160b 100644 --- a/src/pkg/json/encode.go +++ b/src/pkg/json/encode.go @@ -4,6 +4,9 @@ // license that can be found in the LICENSE file. // Package json implements encoding and decoding of JSON objects as defined in // RFC 4627. +// +// See "JSON and Go" for an introduction to this package: +// http://blog.golang.org/2011/01/json-and-go.html package json import ( diff --git a/src/pkg/reflect/type.go b/src/pkg/reflect/type.go index 4c377e1fe10f965a335ddc6e51c82a38e09f8d05..ef0fb87eac363103833c59ee9326a0baab28000d 100644 --- a/src/pkg/reflect/type.go +++ b/src/pkg/reflect/type.go @@ -10,6 +10,9 @@ // // A call to ValueOf returns a Value representing the run-time data. // Zero takes a Type and returns a Value representing a zero value // for that type. +// +// See "The Laws of Reflection" for an introduction to reflection in Go: +// http://blog.golang.org/2011/09/laws-of-reflection.html package reflect import (