test: document ken/*.go

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/5694065

diff --git a/test/ken/array.go b/test/ken/array.go
index 53f6fc88e1cdc29639690949be18805810b66359..9412e3502dd950a12919dfedde52d797e824ed0a 100644 (file)
--- a/test/ken/array.go
+++ b/test/ken/array.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test arrays and slices.
+
 package main
 
 func setpd(a []int) {

diff --git a/test/ken/chan.go b/test/ken/chan.go
index 3bfa5b2d2b7ef23eee4c27d387f35abc96eb93e9..36b18f80ea9faf66423a310d81d8d9bb6f9337a2 100644 (file)
--- a/test/ken/chan.go
+++ b/test/ken/chan.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test communication operations including select.
+
 package main
 
 import "os"

diff --git a/test/ken/chan1.go b/test/ken/chan1.go
index ccb261995924e386eb90a4123ca62feb667b454a..798b058ce40f981e6629346e462cef9694b832e6 100644 (file)
--- a/test/ken/chan1.go
+++ b/test/ken/chan1.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test communication with multiple simultanous goroutines.
+
 package main
 
 import "runtime"

diff --git a/test/ken/complit.go b/test/ken/complit.go
index cab3bca38cdd2a7209bb781bd1b2af1b907249d8..bc50bbe224c35278289513bfed53d2018e0496a4 100644 (file)
--- a/test/ken/complit.go
+++ b/test/ken/complit.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test composite literals.
+
 package main
 
 type   M       map[int]int

diff --git a/test/ken/convert.go b/test/ken/convert.go
index 83e573a3f1997a6d6197574eca6437979f937eb0..33acbd8cd2184f70bab6a6b2c7d4aeac74520132 100644 (file)
--- a/test/ken/convert.go
+++ b/test/ken/convert.go
@@ -4,7 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
-// near-exhaustive test of converting numbers between types.
+// Test, near-exhaustive, of converting numbers between types.
+// No complex numbers though.
 
 package main
 

diff --git a/test/ken/cplx0.go b/test/ken/cplx0.go
index 912b8c489b3d1fae9a58667096ba4574ea5a58bb..665e52a5f3580dd0e558b44ff069ee7b0803350e 100644 (file)
--- a/test/ken/cplx0.go
+++ b/test/ken/cplx0.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test trivial, bootstrap-level complex numbers, including printing.
+
 package main
 
 const (

diff --git a/test/ken/cplx1.go b/test/ken/cplx1.go
index 9421c53e1ecc98d2562d62742a10809d6040e41f..78240a563977c87323a69081ecf3ac379c9ae0cd 100644 (file)
--- a/test/ken/cplx1.go
+++ b/test/ken/cplx1.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test simple arithmetic and assignment for complex numbers.
+
 package main
 
 const (

diff --git a/test/ken/cplx2.go b/test/ken/cplx2.go
index a3c1570ba3296434ab4d2017808d211ec0ac178e..eb1da7b8c0da13529f59c76329331d5536a721c7 100644 (file)
--- a/test/ken/cplx2.go
+++ b/test/ken/cplx2.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test arithmetic on complex numbers, including multiplication and division.
+
 package main
 
 const (

diff --git a/test/ken/cplx3.go b/test/ken/cplx3.go
index 092354983d10cb6e478f456eff08ae4e70df7d0d..be0b8646ab8890c3b005cf273b68bf53d94ec5aa 100644 (file)
--- a/test/ken/cplx3.go
+++ b/test/ken/cplx3.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test composition, decomposition, and reflection on complex numbers.
+
 package main
 
 import "unsafe"

diff --git a/test/ken/cplx4.go b/test/ken/cplx4.go
index 8104ff14d039ed53f1b2c20a9025f4e0eb5f2d92..97d5d16f4aae56470336b0e29624f48191e74cbe 100644 (file)
--- a/test/ken/cplx4.go
+++ b/test/ken/cplx4.go
@@ -4,6 +4,9 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test complex numbers,including fmt support.
+// Used to crash.
+
 package main
 
 import "fmt"

diff --git a/test/ken/cplx5.go b/test/ken/cplx5.go
index 0e2c88221e61082c560e6576dd102e4780ccbb34..4e8f4433d3cb2e076dd6b021608ee6d8de202ac3 100644 (file)
--- a/test/ken/cplx5.go
+++ b/test/ken/cplx5.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test compound types made of complex numbers.
+
 package main
 
 var a [12]complex128

diff --git a/test/ken/divconst.go b/test/ken/divconst.go
index 46786fb67ce019a5e154bcea3b440b97be40a230..670e07417aad71317faa48547da969b8501901d3 100644 (file)
--- a/test/ken/divconst.go
+++ b/test/ken/divconst.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test integer division by constants.
+
 package main
 
 import "math/rand"

diff --git a/test/ken/divmod.go b/test/ken/divmod.go
index 02c762dd04ad30627ec97ae58fa42cf49a2ffad5..f1bd56ec66b85143316214eccc499aeba0816b1e 100644 (file)
--- a/test/ken/divmod.go
+++ b/test/ken/divmod.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test integer division and modulus.
+
 package main
 
 const (

diff --git a/test/ken/embed.go b/test/ken/embed.go
index a3e1980e84370649e22b2cf46818eba03277a87b..9b35c56acfd4deed50375ee0840ce042d65a82f3 100644 (file)
--- a/test/ken/embed.go
+++ b/test/ken/embed.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test embedded fields of structs, including methods.
+
 package main
 
 

diff --git a/test/ken/for.go b/test/ken/for.go
index 914229b5820be4ac66e3181cc45dbe56c14950e1..db35548db8511744778b368bd4a8d8a1702837f7 100644 (file)
--- a/test/ken/for.go
+++ b/test/ken/for.go
@@ -4,6 +4,7 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test simple for loop.
 
 package main
 

diff --git a/test/ken/interbasic.go b/test/ken/interbasic.go
index 113fe3c9be58735dee459564f7ae744ec549a6ae..d8fbb95a311b19be39796cf00d86db02862b118c 100644 (file)
--- a/test/ken/interbasic.go
+++ b/test/ken/interbasic.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test interfaces on basic types.
+
 package main
 
 type myint int

diff --git a/test/ken/interfun.go b/test/ken/interfun.go
index ca875e8378bdfab4ae871f475f3c47dab0f83035..9432181df2aeef625732c081959ea1a2fdf449aa 100644 (file)
--- a/test/ken/interfun.go
+++ b/test/ken/interfun.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test interfaces and methods.
+
 package main
 
 type S struct {

diff --git a/test/ken/intervar.go b/test/ken/intervar.go
index 30815d06b878c668b801e990d7996337a4b6ff60..8a2fca0d4bd069979e7e0b7621bfd61b531d06b2 100644 (file)
--- a/test/ken/intervar.go
+++ b/test/ken/intervar.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test interface assignment.
+
 package main
 
 type   Iputs   interface {

diff --git a/test/ken/label.go b/test/ken/label.go
index b8867a7d1c76ee1d6661bbed51abab1879c8a0bf..fcb3e611d9d6a62ab3f9bb5fed3d7da035c4b3ca 100644 (file)
--- a/test/ken/label.go
+++ b/test/ken/label.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test goto and labels.
+
 package main
 
 func main() {

diff --git a/test/ken/litfun.go b/test/ken/litfun.go
index 4c40ee24ccba62b47a41de096fc8995d5a5d6c85..e241d4edb798a76c9493cc7169b27c842560ff8c 100644 (file)
--- a/test/ken/litfun.go
+++ b/test/ken/litfun.go
@@ -4,6 +4,7 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test simple function literals.
 
 package main
 

diff --git a/test/ken/mfunc.go b/test/ken/mfunc.go
index 2213b8132b2588228259c6d47e3fa94de4a4139d..ef2499194f7add8299c3e8b4a636b765c17acc3f 100644 (file)
--- a/test/ken/mfunc.go
+++ b/test/ken/mfunc.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test simple multi-argument multi-valued function.
+
 package main
 
 func

diff --git a/test/ken/modconst.go b/test/ken/modconst.go
index 3905b8123c05ea28b363c7383cfc13f36c6c839c..d88cf100321d1e4cda890cc1190d0a5e6b03bae2 100644 (file)
--- a/test/ken/modconst.go
+++ b/test/ken/modconst.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test integer modulus by contstants.
+
 package main
 
 import "math/rand"

diff --git a/test/ken/ptrfun.go b/test/ken/ptrfun.go
index b115931566c45014ca97e9943ce8a9a8163ee171..af806cfd9281af8386bfe42fe818a88825c99986 100644 (file)
--- a/test/ken/ptrfun.go
+++ b/test/ken/ptrfun.go
@@ -4,6 +4,7 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test method invocation with pointer receivers and function-valued fields.
 
 package main
 

diff --git a/test/ken/ptrvar.go b/test/ken/ptrvar.go
index c6b4656fc526bd0de3bcdacb77f31ce75388b48e..d78170c9d25a5b7f05dea58180432642026e87db 100644 (file)
--- a/test/ken/ptrvar.go
+++ b/test/ken/ptrvar.go
@@ -4,6 +4,7 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test pointers and the . (selector) operator on structs.
 
 package main
 

diff --git a/test/ken/range.go b/test/ken/range.go
index 07d0e9a677bf1c6b9dc72a57be6b59489dff9d22..89c14e5c35b56076df5c4a6bb83e29e33d8ad0e1 100644 (file)
--- a/test/ken/range.go
+++ b/test/ken/range.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test 'for range' on arrays, slices, and maps.
+
 package main
 
 const size = 16

diff --git a/test/ken/rob1.go b/test/ken/rob1.go
index 35720c928cd6b853b2d072b77de53472504b2187..3042a671bfbfd3d2bbb0bb2d93d21ceee354b0c6 100644 (file)
--- a/test/ken/rob1.go
+++ b/test/ken/rob1.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test general operation using a list implementation.
+
 package main
 
 type Item interface {

diff --git a/test/ken/rob2.go b/test/ken/rob2.go
index bd8a4351581c4504ceb6450b276369fe174b53c0..4b4410ee859fc8bfa95ba388e84a7e1d398282ed 100644 (file)
--- a/test/ken/rob2.go
+++ b/test/ken/rob2.go
@@ -4,6 +4,9 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test general operation using s-list.
+// First Go program ever run (although not in this exact form).
+
 package main
 
 import "fmt"

diff --git a/test/ken/robfor.go b/test/ken/robfor.go
index 958efca3a2c070ecb95c430b7bdf5cfceacf61d9..c6a420b39d7125b07c71dd9c8ab9255ef69059a7 100644 (file)
--- a/test/ken/robfor.go
+++ b/test/ken/robfor.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test for loops of many forms.
+
 package main
 
 func assertequal(is, shouldbe int, msg string) {

diff --git a/test/ken/robfunc.go b/test/ken/robfunc.go
index 40c5b9042a80af3f20933f0ca79527395b7ef000..885267e30c2a613a1cda64c18b81cb017d8047ba 100644 (file)
--- a/test/ken/robfunc.go
+++ b/test/ken/robfunc.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test functions of many signatures.
+
 package main
 
 func assertequal(is, shouldbe int, msg string) {

diff --git a/test/ken/shift.go b/test/ken/shift.go
index c60143d700255964d29671296e3df7eae9872158..af8789615ee5ddc2197c7e845aad16631c88c3f3 100644 (file)
--- a/test/ken/shift.go
+++ b/test/ken/shift.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test shift.
+
 package main
 
 var    ians    [18]int;

diff --git a/test/ken/simparray.go b/test/ken/simparray.go
index 553bc4d6896579f50a400124466a21a57f58d084..0e81a341b8563d3506731199a7e128f57c583444 100644 (file)
--- a/test/ken/simparray.go
+++ b/test/ken/simparray.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test simple operations on arrays.
+
 package main
 
 var b[10] float32;

diff --git a/test/ken/simpbool.go b/test/ken/simpbool.go
index 4a8324ccb7fce051e9698caff646b7a567435bca..ab2ecc21aad7603ebb3c9c3f85a34bc54a6ca993 100644 (file)
--- a/test/ken/simpbool.go
+++ b/test/ken/simpbool.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test basic operations on bool.
+
 package main
 
 type s struct {

diff --git a/test/ken/simpconv.go b/test/ken/simpconv.go
index 9dc7ebf934bea1d2a681c236fa76220e39c33246..22cad2ad0e44a9808424d03edc18cba53aaff2db 100644 (file)
--- a/test/ken/simpconv.go
+++ b/test/ken/simpconv.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test simple arithmetic conversion.
+
 package main
 
 type vlong int64

diff --git a/test/ken/simpfun.go b/test/ken/simpfun.go
index b2c803e8915b08cc65df055cc8efd7f63c15d4c6..e5dc2b24955bfcc7a09163d383f183af1d6ba25a 100644 (file)
--- a/test/ken/simpfun.go
+++ b/test/ken/simpfun.go
@@ -4,6 +4,7 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test simple functions.
 
 package main
 

diff --git a/test/ken/simpswitch.go b/test/ken/simpswitch.go
index cc5f281fcffe8819dc27639009b9fa59cc9c7dfa..b28250b1d38132ebdd98ba6f1ce34c0c52e14be8 100644 (file)
--- a/test/ken/simpswitch.go
+++ b/test/ken/simpswitch.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test simple switch.
+
 package main
 
 func main() {

diff --git a/test/ken/simpvar.go b/test/ken/simpvar.go
index 324008d23611c98b64aa98b54bd102272cd42c59..c6eefbb5addb431c485492917509c3569076ac90 100644 (file)
--- a/test/ken/simpvar.go
+++ b/test/ken/simpvar.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test scoping of variables.
+
 
 package main
 

diff --git a/test/ken/slicearray.go b/test/ken/slicearray.go
index e0f2d322b507ff7c39c5a3e36432ce541c114444..6cf676c588b2558b185a5bf6c70d3d1e8ec595c7 100644 (file)
--- a/test/ken/slicearray.go
+++ b/test/ken/slicearray.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test basic operations of slices and arrays.
+
 package main
 
 var bx [10]byte

diff --git a/test/ken/sliceslice.go b/test/ken/sliceslice.go
index ed1a5fe5a1226cac1aa65a3770c8fec5d19e8667..c07c591252da9d69013a094df5715d1b1992f732 100644 (file)
--- a/test/ken/sliceslice.go
+++ b/test/ken/sliceslice.go
@@ -4,6 +4,8 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test slicing and re-slicing.
+
 package main
 
 var bx []byte

diff --git a/test/ken/string.go b/test/ken/string.go
index 9bd905d3d92e2abb204522e91fb46cecac0e8e98..6df8dc4ddf1939c6fa837a26af0da21879ef328e 100644 (file)
--- a/test/ken/string.go
+++ b/test/ken/string.go
@@ -4,6 +4,7 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test string operations including printing.
 
 package main
 

diff --git a/test/ken/strvar.go b/test/ken/strvar.go
index 34b2621b172a8073c1b78628b99d1c0d90305fc0..4d511fe6735db22b1ebc46d8161d232157f8e154 100644 (file)
--- a/test/ken/strvar.go
+++ b/test/ken/strvar.go
@@ -4,6 +4,7 @@
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
 
+// Test struct-valued variables (not pointers).
 
 package main