From bab4dec14214b27837b2c9c8c3d0f4a08df809b5 Mon Sep 17 00:00:00 2001
From: Rob Pike <r@golang.org>
Date: Wed, 7 Dec 2011 14:33:37 -0800
Subject: [PATCH] doc: skeleton for release note document No content yet other
 than titles and an introductory paragraph. Once this is in, content can arise
 as separate manageable CLs.

R=rsc
CC=golang-dev
https://golang.org/cl/5435090
---
 doc/Makefile |  9 ++----
 doc/go1.html | 81 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 doc/go1.tmpl | 81 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 165 insertions(+), 6 deletions(-)
 create mode 100644 doc/go1.html
 create mode 100644 doc/go1.tmpl

diff --git a/doc/Makefile b/doc/Makefile
index 4d1f4ee0647..4e8ba08c175 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -8,12 +8,9 @@ TARG=tmpltohtml
 GOFILES=\
 	tmpltohtml.go\
 
-all: tmpltohtml go_tutorial.html effective_go.html
+all: tmpltohtml go_tutorial.html effective_go.html go1.html
 
-go_tutorial.html: go_tutorial.tmpl tmpltohtml
-	./makehtml go_tutorial.tmpl
-
-effective_go.html: effective_go.tmpl tmpltohtml
-	./makehtml effective_go.tmpl
+%.html: %.tmpl tmpltohtml
+	./makehtml $*.tmpl
 
 include ../src/Make.cmd
diff --git a/doc/go1.html b/doc/go1.html
new file mode 100644
index 00000000000..507c96fcd29
--- /dev/null
+++ b/doc/go1.html
@@ -0,0 +1,81 @@
+<!-- Go 1 Release Notes -->
+
+<h2 id="introduction">Introduction to Go 1</h2>
+
+<p>
+For a full explanation of the motivation and design of Go 1, see XXX.
+Here follows a summary.
+</p>
+
+<p>
+Go 1 is intended to be a stable language and core library set that will form a reliable foundation for people and organizations that want to make a long-term commitment to developing in the Go programming language. Go will continue to develop, but in a way that guarantees code written to the Go 1 specification will continue to work. For instance, Go 1 will be a supported platform on Google App Engine for the next few years. Incompatible changes to the environment, should they arise, will be done in a distinct version.
+</p>
+
+<p>
+This document describes the changes in the language and libraries in Go 1, relative to the previous release, r60 (at the time of writing, tagged as r60.3). It also explains how to update code at r60 to compile and run under Go 1. Finally, it outlines the new <code>go</code> command for building Go programs and the new binary release process being introduced. Most of these topics have more thorough presentations elsewhere; such documents are linked below.
+
+<h2 id="language">Changes to the language</h2>
+
+<h3 id="append">Append</h3>
+
+<h3 id="close">Close</h3>
+
+<h3 id="composite_literals">Composite literals</h3>
+
+<h3 id="goroutines_init">Goroutines during init</h3>
+
+<h3 id="rune">The rune type</h3>
+
+<h3 id="delete">Deleting from maps</h3>
+
+<h3 id="multiple_assignment">Multiple assignment</h3>
+
+<h3 id="shadowing">Returns and shadowed variables</h3>
+
+<h3 id="struct_equality">Equality of structs and arrays</h3>
+
+<h2 id="library">Changes to the library</h2>
+
+<h3 id="package_hierarchy">The package hierarchy</h3>
+
+<h3 id="errors">The error type</h3>
+
+<h3 id="syscall_errors">System call errors</h3>
+
+<h3 id="time">Time</h3>
+
+<h3 id="html">The html package</h3>
+
+<h3 id="http">The http package</h3>
+
+<h3 id="strconv">The strconv package</h3>
+
+<h3 id="exp">The package tree exp</h3>
+
+<h3 id="old">The package tree old</h3>
+
+<h3 id="deleted_packages">Deleted packages</h3>
+
+<!-- 
+go/typechecker
+go/types
+ebnf (and cmd/ebnflint)
+container/vector
+try (and gotry)
+exp/datafmt
+netchan
+-->
+
+<h3 id="subrepo_packages">Packages moving to subrepositories</h3>
+
+<!-- 
+crypto/openpgp to XXX
+maybe exp/ssh?
+-->
+
+<h3 id="os_fileinfo">The os.FileInfo type</h3>
+
+<h2 id="go_command">The go command</h2>
+
+<h2 id="releases">Packaged releases</h2>
+
diff --git a/doc/go1.tmpl b/doc/go1.tmpl
new file mode 100644
index 00000000000..507c96fcd29
--- /dev/null
+++ b/doc/go1.tmpl
@@ -0,0 +1,81 @@
+<!-- Go 1 Release Notes -->
+
+<h2 id="introduction">Introduction to Go 1</h2>
+
+<p>
+For a full explanation of the motivation and design of Go 1, see XXX.
+Here follows a summary.
+</p>
+
+<p>
+Go 1 is intended to be a stable language and core library set that will form a reliable foundation for people and organizations that want to make a long-term commitment to developing in the Go programming language. Go will continue to develop, but in a way that guarantees code written to the Go 1 specification will continue to work. For instance, Go 1 will be a supported platform on Google App Engine for the next few years. Incompatible changes to the environment, should they arise, will be done in a distinct version.
+</p>
+
+<p>
+This document describes the changes in the language and libraries in Go 1, relative to the previous release, r60 (at the time of writing, tagged as r60.3). It also explains how to update code at r60 to compile and run under Go 1. Finally, it outlines the new <code>go</code> command for building Go programs and the new binary release process being introduced. Most of these topics have more thorough presentations elsewhere; such documents are linked below.
+
+<h2 id="language">Changes to the language</h2>
+
+<h3 id="append">Append</h3>
+
+<h3 id="close">Close</h3>
+
+<h3 id="composite_literals">Composite literals</h3>
+
+<h3 id="goroutines_init">Goroutines during init</h3>
+
+<h3 id="rune">The rune type</h3>
+
+<h3 id="delete">Deleting from maps</h3>
+
+<h3 id="multiple_assignment">Multiple assignment</h3>
+
+<h3 id="shadowing">Returns and shadowed variables</h3>
+
+<h3 id="struct_equality">Equality of structs and arrays</h3>
+
+<h2 id="library">Changes to the library</h2>
+
+<h3 id="package_hierarchy">The package hierarchy</h3>
+
+<h3 id="errors">The error type</h3>
+
+<h3 id="syscall_errors">System call errors</h3>
+
+<h3 id="time">Time</h3>
+
+<h3 id="html">The html package</h3>
+
+<h3 id="http">The http package</h3>
+
+<h3 id="strconv">The strconv package</h3>
+
+<h3 id="exp">The package tree exp</h3>
+
+<h3 id="old">The package tree old</h3>
+
+<h3 id="deleted_packages">Deleted packages</h3>
+
+<!-- 
+go/typechecker
+go/types
+ebnf (and cmd/ebnflint)
+container/vector
+try (and gotry)
+exp/datafmt
+netchan
+-->
+
+<h3 id="subrepo_packages">Packages moving to subrepositories</h3>
+
+<!-- 
+crypto/openpgp to XXX
+maybe exp/ssh?
+-->
+
+<h3 id="os_fileinfo">The os.FileInfo type</h3>
+
+<h2 id="go_command">The go command</h2>
+
+<h2 id="releases">Packaged releases</h2>
+