code review 5491048: go: help messages for 'go test'

go: help messages for 'go test'

The plan is to make 'go test' replace gotest entirely, so it
cannot refer to gotest's godoc.  Instead, copy gotest's
documentation in as three different help messages:
'go help test', 'go help testflag', and 'go help testfunc'.

[rsc, 2011-12-15 03:46:28]

Hello r (cc: golang-dev@googlegroups.com),

I'd like you to review this change to
https://go.googlecode.com/hg/

[r, 2011-12-15 04:24:11]

http://codereview.appspot.com/5491048/diff/2003/src/cmd/go/test.go
File src/cmd/go/test.go (right):

http://codereview.appspot.com/5491048/diff/2003/src/cmd/go/test.go#newcode12
src/cmd/go/test.go:12: 'Go test' automates testing of the packages named by the
import paths.
s/of //

http://codereview.appspot.com/5491048/diff/2003/src/cmd/go/test.go#newcode23
src/cmd/go/test.go:23: the pattern "[^.]*_test.go".  These additional files can
contain test functions,
s/\.go/\\.go$/ ?

or maybe go with

the file pattern "*_test.go"

http://codereview.appspot.com/5491048/diff/2003/src/cmd/go/test.go#newcode67
src/cmd/go/test.go:67: Run only those tests matching the regexp pattern.
maybe here and below
-test.run regexp
  Run only those tests matching the regular expression.

http://codereview.appspot.com/5491048/diff/2003/src/cmd/go/test.go#newcode83
src/cmd/go/test.go:83: To profile all memory allocations, use
-test.memprofilerate 1
s/ 1/=1/

http://codereview.appspot.com/5491048/diff/2003/src/cmd/go/test.go#newcode128
src/cmd/go/test.go:128: in the "[^.]*_test.go" files corresponding to the
package under test.
ditto

http://codereview.appspot.com/5491048/diff/2003/src/cmd/go/test.go#newcode142
src/cmd/go/test.go:142: An example without a doc comment is compiled but not
executed.
Here is an example of an example:

http://codereview.appspot.com/5491048/diff/2003/src/cmd/go/test.go#newcode145
src/cmd/go/test.go:145: func ExampleXXX() {
ExamplePrintln

http://codereview.appspot.com/5491048/diff/2003/src/cmd/go/test.go#newcode149
src/cmd/go/test.go:149: Godoc displays the body of ExampleXXX to demonstrate the
use
move this paragraph up above the example and the example can be ExamplePrintln

[rsc, 2011-12-15 18:41:11]

PTAL

All comments done.

[r, 2011-12-15 18:50:09]

LGTM

[rsc, 2011-12-15 18:54:21]

*** Submitted as http://code.google.com/p/go/source/detail?r=56842d9b23d2 ***

go: help messages for 'go test'

The plan is to make 'go test' replace gotest entirely, so it
cannot refer to gotest's godoc.  Instead, copy gotest's
documentation in as three different help messages:
'go help test', 'go help testflag', and 'go help testfunc'.

R=r
CC=golang-dev
http://codereview.appspot.com/5491048