# HG changeset patch
# User Nick Roberts <nickrob@snap.net.nz>
# Date 1131185367 0
# Node ID c0eb744f79f709c62842c369dfa3cfe59d9adb3c
# Parent  f1ce812719c63ffd05a53ac197dac414f7da8bb2
Describe how to provide preprocessor macro information.

diff -r f1ce812719c6 -r c0eb744f79f7 etc/DEBUG
--- a/etc/DEBUG	Sat Nov 05 10:08:48 2005 +0000
+++ b/etc/DEBUG	Sat Nov 05 10:09:27 2005 +0000
@@ -158,12 +158,13 @@
 
   XVECTOR (this_command_keys)->contents[this_command_key_count++] = key;
 
-XVECTOR is a macro, and therefore, in general, GDB does not know about it.
-Unless Emacs has been compiled with preprocessor macro info, GDB cannot
-evaluate "p XVECTOR (this_command_keys)" .
+XVECTOR is a macro, so GDB only knows about it if Emacs has been compiled with
+preprocessor macro information.  GCC provides this if you specify the options
+`-gdwarf-2' and `-g3'.  In this case, GDB can evaluate expressions like
+"p XVECTOR (this_command_keys)".
 
-However, you can use the xvector command in GDB to get the same
-result.  Here is how:
+When this information isn't available, you can use the xvector command in GDB
+to get the same result.  Here is how:
 
     (gdb) p this_command_keys
     $1 = 1078005760