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.
+