From: Shenghou Ma <minux.ma@gmail.com>
Date: Fri, 21 Sep 2012 19:53:58 +0000 (+1000)
Subject: [release-branch.go1] doc/debugging_with_gdb: mention how to disable gc optimization
X-Git-Tag: go1.0.3~171
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=7d1ddf2b28e18b8a3681700a6e13da75b71b5fa5;p=gostls13.git

[release-branch.go1] doc/debugging_with_gdb: mention how to disable gc optimization

««« backport be7e338a8960
doc/debugging_with_gdb: mention how to disable gc optimization

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/6353055

»»»
---

diff --git a/doc/debugging_with_gdb.html b/doc/debugging_with_gdb.html
index b2683913fc..6b1e2536e0 100644
--- a/doc/debugging_with_gdb.html
+++ b/doc/debugging_with_gdb.html
@@ -23,6 +23,14 @@ Pass the <code>'-s'</code> flag to the linker to omit the debug information
 (for example, <code>go build -ldflags "-s" prog.go</code>).
 </p>
 
+<p>
+The code generated by the <code>gc</code> compiler includes inlining of
+function invocations and registerization of variables. These optimizations
+can sometimes make debugging with <code>gdb</code> harder. To disable them
+when debugging, pass the flags <code>-gcflags "-N -l"</code> to the
+<a href="/cmd/go"><code>go</code></a> command used to build the code being
+debugged.
+</p>
 
 <h3 id="Common_Operations">Common Operations</h3>