From 070fc85831d0d2d1d6c297304502cb66d90ac971 Mon Sep 17 00:00:00 2001 From: Andrew Gerrand Date: Tue, 13 Sep 2011 14:52:58 +1000 Subject: [release-branch.r60] doc: link to notable blog posts MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ««« CL 4996041 / f6fdb6a54203 doc: link to notable blog posts R=golang-dev, r CC=golang-dev https://golang.org/cl/4996041 »»» R=dsymonds CC=golang-dev https://golang.org/cl/4969081 --- 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 +++ 6 files changed, 57 insertions(+), 3 deletions(-) diff --git a/doc/docs.html b/doc/docs.html index 9fd3dcebed..ce833fdd1a 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,12 +62,51 @@ and closures.

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

Belarusian — Беларуская

diff --git a/src/cmd/cgo/doc.go b/src/cmd/cgo/doc.go index 63413825af..a4219867c7 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 dc98b0eca5..088889d2a1 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 35d882afb7..a9284ced7f 100644 --- a/src/pkg/gob/doc.go +++ b/src/pkg/gob/doc.go @@ -221,6 +221,9 @@ In summary, a gob stream looks like 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 3e593fec15..0e6529c6bb 100644 --- a/src/pkg/json/encode.go +++ b/src/pkg/json/encode.go @@ -4,6 +4,9 @@ // 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 4c377e1fe1..ef0fb87eac 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 ( -- cgit v1.2.3-54-g00ecf