From 1aaecd3bed5933e313f8bf86dcb05683678925bc Mon Sep 17 00:00:00 2001 From: Ian Lance Taylor Date: Sat, 24 Jan 2015 00:02:55 +0000 Subject: [PATCH] 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 --- gcc/go/ChangeLog | 9 +++++++++ gcc/go/gccgo.texi | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/gcc/go/ChangeLog b/gcc/go/ChangeLog index d525f5dd7cf..7a624c7de33 100644 --- a/gcc/go/ChangeLog +++ b/gcc/go/ChangeLog @@ -1,3 +1,12 @@ +2015-01-23 Ian Lance Taylor + + 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 PR go/64595 diff --git a/gcc/go/gccgo.texi b/gcc/go/gccgo.texi index 45fc9d718e7..6e4c70874f9 100644 --- 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. -- 2.30.2