re PR go/63565 (please document that (and why) Go binaries should not be stripped)

	PR go/63565
	* gccgo.texi (Invoking gccgo): Mention that Go programs should not
	be stripped.

	* gccgo.texi (C Interoperability): Mention that people should use
	cgo.

From-SVN: r220070

diff --git a/gcc/go/ChangeLog b/gcc/go/ChangeLog
index d525f5dd7cf3291b3086e59303a05e64e6736238..7a624c7de332fd5b4f906e7216ce9e67e276f653 100644 (file)
--- a/gcc/go/ChangeLog
+++ b/gcc/go/ChangeLog
@@ -1,3 +1,12 @@
+2015-01-23  Ian Lance Taylor  <iant@google.com>
+
+       PR go/63565
+       * gccgo.texi (Invoking gccgo): Mention that Go programs should not
+       be stripped.
+
+       * gccgo.texi (C Interoperability): Mention that people should use
+       cgo.
+
 2015-01-23  Ian Lance Taylor  <iant@google.com>
 
        PR go/64595

diff --git a/gcc/go/gccgo.texi b/gcc/go/gccgo.texi
index 45fc9d718e720926ead0c73afaf76d1629db8667..6e4c70874f9800c49c125c62e23a276eb23360ff 100644 (file)
--- a/gcc/go/gccgo.texi
+++ b/gcc/go/gccgo.texi
@@ -142,6 +142,10 @@ the import data directly from the compiled package.  When this package
 is later linked, the compiled form of the package must be included in
 the link command.
 
+Go programs must generally be compiled with debugging information, and
+@option{-g1} is the default as described below.  Stripping a Go
+program will generally cause it to misbehave or fail.
+
 @c man end
 
 @c man begin OPTIONS gccgo
@@ -288,6 +292,11 @@ This is different from the behaviour of other Go compilers.
 When using @command{gccgo} there is limited interoperability with C,
 or with C++ code compiled using @code{extern "C"}.
 
+This information is provided largely for documentation purposes.  For
+ordinary use it is best to build programs with the go tool and then
+use @code{import "C"}, as described at
+@url{http://golang.org/cmd/cgo}.
+
 @menu
 * C Type Interoperability::     How C and Go types match up.
 * Function Names::              How Go functions are named.