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