aboutsummaryrefslogtreecommitdiff
path: root/gcc/go/gccgo.texi
diff options
context:
space:
mode:
authorIan Lance Taylor <iant@google.com>2015-01-24 00:02:55 +0000
committerIan Lance Taylor <ian@gcc.gnu.org>2015-01-24 00:02:55 +0000
commit1aaecd3bed5933e313f8bf86dcb05683678925bc (patch)
tree3d49b71e0915faf3b497f1587bb53f20819c6e09 /gcc/go/gccgo.texi
parent6ed7da8948faa44a6fbbdd4fe8ea2935f5f1c6e1 (diff)
downloadgcc-1aaecd3bed5933e313f8bf86dcb05683678925bc.zip
gcc-1aaecd3bed5933e313f8bf86dcb05683678925bc.tar.gz
gcc-1aaecd3bed5933e313f8bf86dcb05683678925bc.tar.bz2
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
Diffstat (limited to 'gcc/go/gccgo.texi')
-rw-r--r--gcc/go/gccgo.texi9
1 files changed, 9 insertions, 0 deletions
diff --git a/gcc/go/gccgo.texi b/gcc/go/gccgo.texi
index 45fc9d7..6e4c708 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.