code review 5533057: pkg: add missing godoc comments to windows versions

src/buildscript_darwin_386.sh

 #!/usr/bin/env bash
 # AUTO-GENERATED by buildscript.sh; DO NOT EDIT.
 # This script builds the go command (written in Go),
 # and then the go command can build the rest of the tree.
 
 export GOOS=darwin
 export GOARCH=386
 export WORK=$(mktemp -d -t go-build.XXXXXX)
 trap "rm -rf $WORK" EXIT SIGINT SIGTERM
 set -e
@@ skipping 209 matching lines @@
 #
 
 mkdir -p "$WORK"/encoding/base64/_obj/
 cd "$GOROOT"/src/pkg/encoding/base64
 8g -o "$WORK"/encoding/base64/_obj/_go_.8 -p encoding/base64 -I "$WORK" ./base64.go
 gopack grc "$WORK"/encoding/base64.a "$WORK"/encoding/base64/_obj/_go_.8
 mkdir -p "$GOROOT"/pkg/darwin_386/encoding/
 cp "$WORK"/encoding/base64.a "$GOROOT"/pkg/darwin_386/encoding/base64.a
 
 #
+# syscall
+#
+
+mkdir -p "$WORK"/syscall/_obj/
+cd "$GOROOT"/src/pkg/syscall
+8g -o "$WORK"/syscall/_obj/_go_.8 -p syscall -I "$WORK" ./bpf_bsd.go ./env_unix.go ./exec_bsd.go ./exec_unix.go ./route_bsd.go ./route_darwin.go ./sockcmsg_unix.go ./str.go ./syscall.go ./syscall_bsd.go ./syscall_darwin.go ./syscall_darwin_386.go ./syscall_unix.go ./zerrors_darwin_386.go ./zsyscall_darwin_386.go ./zsysnum_darwin_386.go ./ztypes_darwin_386.go
+8a -I "$WORK"/syscall/_obj/ -o "$WORK"/syscall/_obj/asm_darwin_386.8 -DGOOS_darwin -DGOARCH_386 ./asm_darwin_386.s
+gopack grc "$WORK"/syscall.a "$WORK"/syscall/_obj/_go_.8 "$WORK"/syscall/_obj/asm_darwin_386.8
+cp "$WORK"/syscall.a "$GOROOT"/pkg/darwin_386/syscall.a
+
+#
+# time
+#
+
+mkdir -p "$WORK"/time/_obj/
+cd "$GOROOT"/src/pkg/time
+8g -o "$WORK"/time/_obj/_go_.8 -p time -I "$WORK" ./format.go ./sleep.go ./sys_unix.go ./tick.go ./time.go ./zoneinfo.go ./zoneinfo_unix.go
+gopack grc "$WORK"/time.a "$WORK"/time/_obj/_go_.8
+cp "$WORK"/time.a "$GOROOT"/pkg/darwin_386/time.a
+
+#
+# os
+#
+
+mkdir -p "$WORK"/os/_obj/
+cd "$GOROOT"/src/pkg/os
+8g -o "$WORK"/os/_obj/_go_.8 -p os -I "$WORK" ./dir_unix.go ./doc.go ./env.go ./error.go ./error_posix.go ./exec.go ./exec_posix.go ./exec_unix.go ./file.go ./file_posix.go ./file_unix.go ./getwd.go ./path.go ./path_unix.go ./proc.go ./stat_darwin.go ./sys_bsd.go ./time.go ./types.go ./zsignal_darwin_386.go
+gopack grc "$WORK"/os.a "$WORK"/os/_obj/_go_.8
+cp "$WORK"/os.a "$GOROOT"/pkg/darwin_386/os.a
+
+#
 # reflect
 #
 
 mkdir -p "$WORK"/reflect/_obj/
 cd "$GOROOT"/src/pkg/reflect
 8g -o "$WORK"/reflect/_obj/_go_.8 -p reflect -I "$WORK" ./deepequal.go ./type.go ./value.go
 gopack grc "$WORK"/reflect.a "$WORK"/reflect/_obj/_go_.8
 cp "$WORK"/reflect.a "$GOROOT"/pkg/darwin_386/reflect.a
 
 #
+# fmt
+#
+
+mkdir -p "$WORK"/fmt/_obj/
+cd "$GOROOT"/src/pkg/fmt
+8g -o "$WORK"/fmt/_obj/_go_.8 -p fmt -I "$WORK" ./doc.go ./format.go ./print.go ./scan.go
+gopack grc "$WORK"/fmt.a "$WORK"/fmt/_obj/_go_.8
+cp "$WORK"/fmt.a "$GOROOT"/pkg/darwin_386/fmt.a
+
+#
 # unicode/utf16
 #
 
 mkdir -p "$WORK"/unicode/utf16/_obj/
 cd "$GOROOT"/src/pkg/unicode/utf16
 8g -o "$WORK"/unicode/utf16/_obj/_go_.8 -p unicode/utf16 -I "$WORK" ./utf16.go
 gopack grc "$WORK"/unicode/utf16.a "$WORK"/unicode/utf16/_obj/_go_.8
 cp "$WORK"/unicode/utf16.a "$GOROOT"/pkg/darwin_386/unicode/utf16.a
 
 #
 # encoding/json
 #
 
 mkdir -p "$WORK"/encoding/json/_obj/
 cd "$GOROOT"/src/pkg/encoding/json
 8g -o "$WORK"/encoding/json/_obj/_go_.8 -p encoding/json -I "$WORK" ./decode.go ./encode.go ./indent.go ./scanner.go ./stream.go ./tags.go
 gopack grc "$WORK"/encoding/json.a "$WORK"/encoding/json/_obj/_go_.8
 cp "$WORK"/encoding/json.a "$GOROOT"/pkg/darwin_386/encoding/json.a
-
-#
-# syscall
-#
-
-mkdir -p "$WORK"/syscall/_obj/
-cd "$GOROOT"/src/pkg/syscall
-8g -o "$WORK"/syscall/_obj/_go_.8 -p syscall -I "$WORK" ./bpf_bsd.go ./env_unix.go ./exec_bsd.go ./exec_unix.go ./route_bsd.go ./route_darwin.go ./sockcmsg_unix.go ./str.go ./syscall.go ./syscall_386.go ./syscall_bsd.go ./syscall_darwin.go ./syscall_darwin_386.go ./syscall_unix.go ./zerrors_darwin_386.go ./zsyscall_darwin_386.go ./zsysnum_darwin_386.go ./ztypes_darwin_386.go
-8a -I "$WORK"/syscall/_obj/ -o "$WORK"/syscall/_obj/asm_darwin_386.8 -DGOOS_darwin -DGOARCH_386 ./asm_darwin_386.s
-gopack grc "$WORK"/syscall.a "$WORK"/syscall/_obj/_go_.8 "$WORK"/syscall/_obj/asm_darwin_386.8
-cp "$WORK"/syscall.a "$GOROOT"/pkg/darwin_386/syscall.a
-
-#
-# time
-#
-
-mkdir -p "$WORK"/time/_obj/
-cd "$GOROOT"/src/pkg/time
-8g -o "$WORK"/time/_obj/_go_.8 -p time -I "$WORK" ./format.go ./sleep.go ./sys_unix.go ./tick.go ./time.go ./zoneinfo.go ./zoneinfo_unix.go
-gopack grc "$WORK"/time.a "$WORK"/time/_obj/_go_.8
-cp "$WORK"/time.a "$GOROOT"/pkg/darwin_386/time.a
-
-#
-# os
-#
-
-mkdir -p "$WORK"/os/_obj/
-cd "$GOROOT"/src/pkg/os
-8g -o "$WORK"/os/_obj/_go_.8 -p os -I "$WORK" ./dir_unix.go ./doc.go ./env.go ./error.go ./error_posix.go ./exec.go ./exec_posix.go ./exec_unix.go ./file.go ./file_posix.go ./file_unix.go ./getwd.go ./path.go ./path_unix.go ./proc.go ./stat_darwin.go ./sys_bsd.go ./time.go ./types.go ./zsignal_darwin_386.go
-gopack grc "$WORK"/os.a "$WORK"/os/_obj/_go_.8
-cp "$WORK"/os.a "$GOROOT"/pkg/darwin_386/os.a
-
-#
-# fmt
-#
-
-mkdir -p "$WORK"/fmt/_obj/
-cd "$GOROOT"/src/pkg/fmt
-8g -o "$WORK"/fmt/_obj/_go_.8 -p fmt -I "$WORK" ./doc.go ./format.go ./print.go ./scan.go
-gopack grc "$WORK"/fmt.a "$WORK"/fmt/_obj/_go_.8
-cp "$WORK"/fmt.a "$GOROOT"/pkg/darwin_386/fmt.a
 
 #
 # flag
 #
 
 mkdir -p "$WORK"/flag/_obj/
 cd "$GOROOT"/src/pkg/flag
 8g -o "$WORK"/flag/_obj/_go_.8 -p flag -I "$WORK" ./flag.go
 gopack grc "$WORK"/flag.a "$WORK"/flag/_obj/_go_.8
 cp "$WORK"/flag.a "$GOROOT"/pkg/darwin_386/flag.a
@@ skipping 54 matching lines @@
 # go/ast
 #
 
 mkdir -p "$WORK"/go/ast/_obj/
 cd "$GOROOT"/src/pkg/go/ast
 8g -o "$WORK"/go/ast/_obj/_go_.8 -p go/ast -I "$WORK" ./ast.go ./filter.go ./import.go ./print.go ./resolve.go ./scope.go ./walk.go
 gopack grc "$WORK"/go/ast.a "$WORK"/go/ast/_obj/_go_.8
 cp "$WORK"/go/ast.a "$GOROOT"/pkg/darwin_386/go/ast.a
 
 #
-# text/tabwriter
-#
-
-mkdir -p "$WORK"/text/tabwriter/_obj/
-cd "$GOROOT"/src/pkg/text/tabwriter
-8g -o "$WORK"/text/tabwriter/_obj/_go_.8 -p text/tabwriter -I "$WORK" ./tabwriter.go
-gopack grc "$WORK"/text/tabwriter.a "$WORK"/text/tabwriter/_obj/_go_.8
-mkdir -p "$GOROOT"/pkg/darwin_386/text/
-cp "$WORK"/text/tabwriter.a "$GOROOT"/pkg/darwin_386/text/tabwriter.a
-
-#
-# go/printer
-#
-
-mkdir -p "$WORK"/go/printer/_obj/
-cd "$GOROOT"/src/pkg/go/printer
-8g -o "$WORK"/go/printer/_obj/_go_.8 -p go/printer -I "$WORK" ./nodes.go ./printer.go
-gopack grc "$WORK"/go/printer.a "$WORK"/go/printer/_obj/_go_.8
-cp "$WORK"/go/printer.a "$GOROOT"/pkg/darwin_386/go/printer.a
+# io/ioutil
+#
+
+mkdir -p "$WORK"/io/ioutil/_obj/
+cd "$GOROOT"/src/pkg/io/ioutil
+8g -o "$WORK"/io/ioutil/_obj/_go_.8 -p io/ioutil -I "$WORK" ./ioutil.go ./tempfile.go
+gopack grc "$WORK"/io/ioutil.a "$WORK"/io/ioutil/_obj/_go_.8
+mkdir -p "$GOROOT"/pkg/darwin_386/io/
+cp "$WORK"/io/ioutil.a "$GOROOT"/pkg/darwin_386/io/ioutil.a
+
+#
+# go/parser
+#
+
+mkdir -p "$WORK"/go/parser/_obj/
+cd "$GOROOT"/src/pkg/go/parser
+8g -o "$WORK"/go/parser/_obj/_go_.8 -p go/parser -I "$WORK" ./interface.go ./parser.go
+gopack grc "$WORK"/go/parser.a "$WORK"/go/parser/_obj/_go_.8
+cp "$WORK"/go/parser.a "$GOROOT"/pkg/darwin_386/go/parser.a
+
+#
+# log
+#
+
+mkdir -p "$WORK"/log/_obj/
+cd "$GOROOT"/src/pkg/log
+8g -o "$WORK"/log/_obj/_go_.8 -p log -I "$WORK" ./log.go
+gopack grc "$WORK"/log.a "$WORK"/log/_obj/_go_.8
+cp "$WORK"/log.a "$GOROOT"/pkg/darwin_386/log.a
+
+#
+# os/exec
+#
+
+mkdir -p "$WORK"/os/exec/_obj/
+cd "$GOROOT"/src/pkg/os/exec
+8g -o "$WORK"/os/exec/_obj/_go_.8 -p os/exec -I "$WORK" ./exec.go ./lp_unix.go
+gopack grc "$WORK"/os/exec.a "$WORK"/os/exec/_obj/_go_.8
+mkdir -p "$GOROOT"/pkg/darwin_386/os/
+cp "$WORK"/os/exec.a "$GOROOT"/pkg/darwin_386/os/exec.a
+
+#
+# path
+#
+
+mkdir -p "$WORK"/path/_obj/
+cd "$GOROOT"/src/pkg/path
+8g -o "$WORK"/path/_obj/_go_.8 -p path -I "$WORK" ./match.go ./path.go
+gopack grc "$WORK"/path.a "$WORK"/path/_obj/_go_.8
+cp "$WORK"/path.a "$GOROOT"/pkg/darwin_386/path.a
 
 #
 # regexp/syntax
 #
 
 mkdir -p "$WORK"/regexp/syntax/_obj/
 cd "$GOROOT"/src/pkg/regexp/syntax
 8g -o "$WORK"/regexp/syntax/_obj/_go_.8 -p regexp/syntax -I "$WORK" ./compile.go ./parse.go ./perl_groups.go ./prog.go ./regexp.go ./simplify.go
 gopack grc "$WORK"/regexp/syntax.a "$WORK"/regexp/syntax/_obj/_go_.8
 mkdir -p "$GOROOT"/pkg/darwin_386/regexp/
 cp "$WORK"/regexp/syntax.a "$GOROOT"/pkg/darwin_386/regexp/syntax.a
 
 #
 # regexp
 #
 
 mkdir -p "$WORK"/regexp/_obj/
 cd "$GOROOT"/src/pkg/regexp
 8g -o "$WORK"/regexp/_obj/_go_.8 -p regexp -I "$WORK" ./exec.go ./regexp.go
 gopack grc "$WORK"/regexp.a "$WORK"/regexp/_obj/_go_.8
 cp "$WORK"/regexp.a "$GOROOT"/pkg/darwin_386/regexp.a
 
 #
-# io/ioutil
-#
-
-mkdir -p "$WORK"/io/ioutil/_obj/
-cd "$GOROOT"/src/pkg/io/ioutil
-8g -o "$WORK"/io/ioutil/_obj/_go_.8 -p io/ioutil -I "$WORK" ./ioutil.go ./tempfile.go
-gopack grc "$WORK"/io/ioutil.a "$WORK"/io/ioutil/_obj/_go_.8
-mkdir -p "$GOROOT"/pkg/darwin_386/io/
-cp "$WORK"/io/ioutil.a "$GOROOT"/pkg/darwin_386/io/ioutil.a
+# go/build
+#
+
+mkdir -p "$WORK"/go/build/_obj/
+cd "$GOROOT"/src/pkg/go/build
+8g -o "$WORK"/go/build/_obj/_go_.8 -p go/build -I "$WORK" ./build.go ./dir.go ./path.go ./syslist.go
+gopack grc "$WORK"/go/build.a "$WORK"/go/build/_obj/_go_.8
+cp "$WORK"/go/build.a "$GOROOT"/pkg/darwin_386/go/build.a
 
 #
 # net/url
 #
 
 mkdir -p "$WORK"/net/url/_obj/
 cd "$GOROOT"/src/pkg/net/url
 8g -o "$WORK"/net/url/_obj/_go_.8 -p net/url -I "$WORK" ./url.go
 gopack grc "$WORK"/net/url.a "$WORK"/net/url/_obj/_go_.8
 mkdir -p "$GOROOT"/pkg/darwin_386/net/
@@ skipping 11 matching lines @@
 cp "$WORK"/text/template/parse.a "$GOROOT"/pkg/darwin_386/text/template/parse.a
 
 #
 # text/template
 #
 
 mkdir -p "$WORK"/text/template/_obj/
 cd "$GOROOT"/src/pkg/text/template
 8g -o "$WORK"/text/template/_obj/_go_.8 -p text/template -I "$WORK" ./doc.go ./exec.go ./funcs.go ./helper.go ./template.go
 gopack grc "$WORK"/text/template.a "$WORK"/text/template/_obj/_go_.8
+mkdir -p "$GOROOT"/pkg/darwin_386/text/
 cp "$WORK"/text/template.a "$GOROOT"/pkg/darwin_386/text/template.a
-
-#
-# go/doc
-#
-
-mkdir -p "$WORK"/go/doc/_obj/
-cd "$GOROOT"/src/pkg/go/doc
-8g -o "$WORK"/go/doc/_obj/_go_.8 -p go/doc -I "$WORK" ./comment.go ./doc.go ./example.go ./exports.go ./filter.go ./reader.go
-gopack grc "$WORK"/go/doc.a "$WORK"/go/doc/_obj/_go_.8
-cp "$WORK"/go/doc.a "$GOROOT"/pkg/darwin_386/go/doc.a
-
-#
-# go/parser
-#
-
-mkdir -p "$WORK"/go/parser/_obj/
-cd "$GOROOT"/src/pkg/go/parser
-8g -o "$WORK"/go/parser/_obj/_go_.8 -p go/parser -I "$WORK" ./interface.go ./parser.go
-gopack grc "$WORK"/go/parser.a "$WORK"/go/parser/_obj/_go_.8
-cp "$WORK"/go/parser.a "$GOROOT"/pkg/darwin_386/go/parser.a
-
-#
-# log
-#
-
-mkdir -p "$WORK"/log/_obj/
-cd "$GOROOT"/src/pkg/log
-8g -o "$WORK"/log/_obj/_go_.8 -p log -I "$WORK" ./log.go
-gopack grc "$WORK"/log.a "$WORK"/log/_obj/_go_.8
-cp "$WORK"/log.a "$GOROOT"/pkg/darwin_386/log.a
-
-#
-# os/exec
-#
-
-mkdir -p "$WORK"/os/exec/_obj/
-cd "$GOROOT"/src/pkg/os/exec
-8g -o "$WORK"/os/exec/_obj/_go_.8 -p os/exec -I "$WORK" ./exec.go ./lp_unix.go
-gopack grc "$WORK"/os/exec.a "$WORK"/os/exec/_obj/_go_.8
-mkdir -p "$GOROOT"/pkg/darwin_386/os/
-cp "$WORK"/os/exec.a "$GOROOT"/pkg/darwin_386/os/exec.a
-
-#
-# path
-#
-
-mkdir -p "$WORK"/path/_obj/
-cd "$GOROOT"/src/pkg/path
-8g -o "$WORK"/path/_obj/_go_.8 -p path -I "$WORK" ./match.go ./path.go
-gopack grc "$WORK"/path.a "$WORK"/path/_obj/_go_.8
-cp "$WORK"/path.a "$GOROOT"/pkg/darwin_386/path.a
-
-#
-# go/build
-#
-
-mkdir -p "$WORK"/go/build/_obj/
-cd "$GOROOT"/src/pkg/go/build
-8g -o "$WORK"/go/build/_obj/_go_.8 -p go/build -I "$WORK" ./build.go ./dir.go ./path.go ./syslist.go
-gopack grc "$WORK"/go/build.a "$WORK"/go/build/_obj/_go_.8
-cp "$WORK"/go/build.a "$GOROOT"/pkg/darwin_386/go/build.a
 
 #
 # cmd/go
 #
 
 mkdir -p "$WORK"/cmd/go/_obj/
 cd "$GOROOT"/src/cmd/go
 8g -o "$WORK"/cmd/go/_obj/_go_.8 -p cmd/go -I "$WORK" ./build.go ./fix.go ./fmt.go ./get.go ./help.go ./list.go ./main.go ./pkg.go ./run.go ./test.go ./testflag.go ./version.go ./vet.go
 gopack grc "$WORK"/cmd/go.a "$WORK"/cmd/go/_obj/_go_.8
 8l -o "$WORK"/cmd/go/_obj/a.out -L "$WORK" "$WORK"/cmd/go.a
 mkdir -p "$GOBIN"/
 cp "$WORK"/cmd/go/_obj/a.out "$GOBIN"/go