aboutsummaryrefslogtreecommitdiffstats
path: root/etc/DEBUG
diff options
context:
space:
mode:
Diffstat (limited to 'etc/DEBUG')
-rw-r--r--etc/DEBUG29
1 files changed, 10 insertions, 19 deletions
diff --git a/etc/DEBUG b/etc/DEBUG
index b4272929bae..6fd5b412f4c 100644
--- a/etc/DEBUG
+++ b/etc/DEBUG
@@ -5,9 +5,8 @@ Copyright (C) 1985, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
5See the end of the file for license conditions. 5See the end of the file for license conditions.
6 6
7 7
8[People who debug Emacs on Windows using Microsoft debuggers 8[People who debug Emacs on Windows using Microsoft debuggers should
9should read the Windows-specific section near the end of this 9read the Windows-specific section near the end of this document.]
10document.]
11 10
12** When you debug Emacs with GDB, you should start it in the directory 11** When you debug Emacs with GDB, you should start it in the directory
13where the executable was made. That directory has a .gdbinit file 12where the executable was made. That directory has a .gdbinit file
@@ -50,8 +49,7 @@ On modern POSIX systems, you can override that with this command:
50 handle SIGINT stop nopass 49 handle SIGINT stop nopass
51 50
52After this `handle' command, SIGINT will return control to GDB. If 51After this `handle' command, SIGINT will return control to GDB. If
53you want the C-g to cause a QUIT within Emacs as well, omit the 52you want the C-g to cause a QUIT within Emacs as well, omit the `nopass'.
54`nopass'.
55 53
56A technique that can work when `handle SIGINT' does not is to store 54A technique that can work when `handle SIGINT' does not is to store
57the code for some character into the variable stop_character. Thus, 55the code for some character into the variable stop_character. Thus,
@@ -443,10 +441,9 @@ It is necessary to refer to the file `nmout' to convert
443numeric addresses into symbols and vice versa. 441numeric addresses into symbols and vice versa.
444 442
445It is useful to be running under a window system. 443It is useful to be running under a window system.
446Then, if Emacs becomes hopelessly wedged, you can create 444Then, if Emacs becomes hopelessly wedged, you can create another
447another window to do kill -9 in. kill -ILL is often 445window to do kill -9 in. kill -ILL is often useful too, since that
448useful too, since that may make Emacs dump core or return 446may make Emacs dump core or return to adb.
449to adb.
450 447
451 448
452** Debugging incorrect screen updating. 449** Debugging incorrect screen updating.
@@ -483,16 +480,14 @@ suitable for Unix and GNU systems, to build such a debugging version:
483Building Emacs like that activates many assertions which scrutinize 480Building Emacs like that activates many assertions which scrutinize
484display code operation more than Emacs does normally. (To see the 481display code operation more than Emacs does normally. (To see the
485code which tests these assertions, look for calls to the `xassert' 482code which tests these assertions, look for calls to the `xassert'
486macros.) Any assertion that is reported to fail should be 483macros.) Any assertion that is reported to fail should be investigated.
487investigated.
488 484
489Building with GLYPH_DEBUG defined also defines several helper 485Building with GLYPH_DEBUG defined also defines several helper
490functions which can help debugging display code. One such function is 486functions which can help debugging display code. One such function is
491`dump_glyph_matrix'. If you run Emacs under GDB, you can print the 487`dump_glyph_matrix'. If you run Emacs under GDB, you can print the
492contents of any glyph matrix by just calling that function with the 488contents of any glyph matrix by just calling that function with the
493matrix as its argument. For example, the following command will print 489matrix as its argument. For example, the following command will print
494the contents of the current matrix of the window whose pointer is in 490the contents of the current matrix of the window whose pointer is in `w':
495`w':
496 491
497 (gdb) p dump_glyph_matrix (w->current_matrix, 2) 492 (gdb) p dump_glyph_matrix (w->current_matrix, 2)
498 493
@@ -621,13 +616,9 @@ Emacs compiled with such packages might not run without some hacking,
621because Emacs replaces the system's memory allocation functions with 616because Emacs replaces the system's memory allocation functions with
622its own versions, and because the dumping process might be 617its own versions, and because the dumping process might be
623incompatible with the way these packages use to track allocated 618incompatible with the way these packages use to track allocated
624memory. Here are some of the changes you might find necessary 619memory. Here are some of the changes you might find necessary:
625(SYSTEM-NAME and MACHINE-NAME are the names of your OS- and
626CPU-specific headers in the subdirectories of `src'):
627 620
628 - In src/s/SYSTEM-NAME.h add "#define SYSTEM_MALLOC". 621 - Edit configure, to set system_malloc and CANNOT_DUMP to "yes".
629
630 - In src/m/MACHINE-NAME.h add "#define CANNOT_DUMP"
631 622
632 - Configure with a different --prefix= option. If you use GCC, 623 - Configure with a different --prefix= option. If you use GCC,
633 version 2.7.2 is preferred, as some malloc debugging packages 624 version 2.7.2 is preferred, as some malloc debugging packages