From: Shenghou Ma <minux.ma@gmail.com>
Date: Tue, 3 Jul 2012 16:50:03 +0000 (-0400)
Subject: doc/debugging_with_gdb: mention how to disable gc optimization
X-Git-Tag: go1.1rc2~2838
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=d9c4cef67050791892511d1c2cb653dbcb15204c;p=gostls13.git

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>