code review 13733043: cmd/cgo: rearrange and update documentation

cmd/cgo: rearrange and update documentation

In particular document that the Go tool will look for certain
file extensions and compile with them with either the C or the
C++ compiler.

Fixes issue 6393.

[iant, 2013-09-17 00:05:10]

Hello golang-dev@googlegroups.com,

I'd like you to review this change to
https://code.google.com/p/go

[r, 2013-09-17 02:56:53]

chunk mismatch. please upload.

[iant, 2013-09-17 03:06:33]

On 2013/09/17 02:56:53, r wrote:
> chunk mismatch. please upload.

Done.

[r, 2013-09-17 03:11:10]

LGTM but please rework that one sentence.

https://codereview.appspot.com/13733043/diff/5001/src/cmd/cgo/doc.go
File src/cmd/cgo/doc.go (right):

https://codereview.appspot.com/13733043/diff/5001/src/cmd/cgo/doc.go#newcode47
src/cmd/cgo/doc.go:47: When building the CGO_CFLAGS, CGO_CPPFLAGS, CGO_CXXFLAGS
and
s/building/&,/

https://codereview.appspot.com/13733043/diff/5001/src/cmd/cgo/doc.go#newcode58
src/cmd/cgo/doc.go:58: not be compiled separately, but if they change the C and
C++ files
what does 'if they change' mean? in any case there's a punctuation problem in
this sentence. missing comma after 'change'?

[iant, 2013-09-17 14:11:46]

*** Submitted as https://code.google.com/p/go/source/detail?r=32c277e8c68c ***

cmd/cgo: rearrange and update documentation

In particular document that the Go tool will look for certain
file extensions and compile with them with either the C or the
C++ compiler.

Fixes issue 6393.

R=golang-dev, r
CC=golang-dev
https://codereview.appspot.com/13733043