From d9c4cef67050791892511d1c2cb653dbcb15204c Mon Sep 17 00:00:00 2001
From: Shenghou Ma <minux.ma@gmail.com>
Date: Tue, 3 Jul 2012 12:50:03 -0400
Subject: [PATCH] doc/debugging_with_gdb: mention how to disable gc
 optimization

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/6353055
---
 doc/debugging_with_gdb.html | 8 ++++++++
 1 file changed, 8 insertions(+)

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>