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 '-s'
flag to the linker to omit the debug information
(for example, go build -ldflags "-s" prog.go
).
+The code generated by the gc
compiler includes inlining of
+function invocations and registerization of variables. These optimizations
+can sometimes make debugging with gdb
harder. To disable them
+when debugging, pass the flags -gcflags "-N -l"
to the
+go
command used to build the code being
+debugged.
+