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.
@@ -62,12 +62,51 @@ and closures.
Guided tours of Go programs.
+
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