[Emacs-diffs] trunk r112967: * DEBUG: Document -Og.

[Paul Eggert]

------------------------------------------------------------
revno: 112967
revision-id: address@hidden
parent: address@hidden
committer: Paul Eggert <address@hidden>
branch nick: trunk
timestamp: Thu 2013-06-13 10:04:08 -0700
message:
  * DEBUG: Document -Og.
modified:
  etc/ChangeLog                  changelog-20091113204419-o5vbwnq5f7feedwu-1485
  etc/DEBUG                      debug-20091113204419-o5vbwnq5f7feedwu-1486

=== modified file 'etc/ChangeLog'
--- a/etc/ChangeLog     2013-06-05 18:31:48 +0000
+++ b/etc/ChangeLog     2013-06-13 17:04:08 +0000
@@ -1,3 +1,7 @@
+2013-06-13  Paul Eggert  <address@hidden>
+
+       * DEBUG: Document -Og.
+
 2013-06-05  Teodor Zlatanov  <address@hidden>
 
        * NEWS: Document new prog-mode symbol prettify support.

=== modified file 'etc/DEBUG'
--- a/etc/DEBUG 2013-02-22 09:22:21 +0000
+++ b/etc/DEBUG 2013-06-13 17:04:08 +0000
@@ -24,8 +24,10 @@
 described in the node "Auto-loading safe path" in the GDB user manual.
 
 ** When you are trying to analyze failed assertions or backtraces, it
-will be essential to compile Emacs either completely without
-optimizations (set CFLAGS to "-O0 -g3") or at least (when using GCC)
+is essential to compile Emacs with flags suitable for debugging.
+With GCC 4.8 or later, you can invoke 'make' with CFLAGS="-Og -g3".
+With older GCC or non-GCC commpilers, you can use CFLAGS="-O0 -g3".
+With GCC and higher optimization levels such as -O2, at least compile
 with the -fno-crossjumping option in CFLAGS.  Failure to do so may
 make the compiler recycle the same abort call for all assertions in a
 given function, rendering the stack backtrace useless for identifying
@@ -769,4 +771,3 @@
 mode: outline
 paragraph-separate: "[         ]*$"
 end:
-