From: Sean Whitton <spwhitton@spwhitton.name>
Date: Wed, 30 Apr 2025 09:12:50 +0000 (+0800)
Subject: ; * etc/DEBUG: Add link to GCC bug #78685.
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=b25bbf1b933e6fdc06f2f00047035daba1d818fc;p=emacs.git

; * etc/DEBUG: Add link to GCC bug #78685.

(cherry picked from commit d56e5ba97ee49bc7d82ad21e35ac8fbc21a0b0e1)
---

diff --git a/etc/DEBUG b/etc/DEBUG
index ee920a6e89c..0d149534d19 100644
--- a/etc/DEBUG
+++ b/etc/DEBUG
@@ -20,7 +20,7 @@ such as --prefix):
     CFLAGS='-O0 -g3'
 
 The -O0 flag is important, as debugging optimized code can be hard, even
-in the case that the -Og compiler option is used.  If the problem
+in the case that the -Og compiler option is used.[1]  If the problem
 happens only with optimized code, you may need to enable optimizations.
 If that happens, try using -Og first instead of -O2, as -Og disables
 some optimizations that make debugging some code exceptionally hard.
@@ -38,6 +38,9 @@ this below under "Debugging Emacs redisplay problems".
 Emacs needs not be installed to be debugged, you can debug the binary
 created in the 'src' directory.
 
+[1]  gcc's -Og has some known problems and limitations, documented here:
+     https://gcc.gnu.org/bugzilla/show_bug.cgi?id=78685
+
 *** Configuring GDB
 
 To start GDB to debug Emacs, you can simply type "gdb ./emacs RET" at