[Emacs-diffs] /srv/bzr/emacs/trunk r110125: * trouble.texi (Crashing): Document addr2line.

[Paul Eggert]

------------------------------------------------------------
revno: 110125
committer: Paul Eggert <address@hidden>
branch nick: trunk
timestamp: Fri 2012-09-21 12:28:41 -0700
message:
  * trouble.texi (Crashing): Document addr2line.
modified:
  doc/emacs/ChangeLog
  doc/emacs/trouble.texi

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2012-09-19 06:51:33 +0000
+++ b/doc/emacs/ChangeLog       2012-09-21 19:28:41 +0000
@@ -1,3 +1,7 @@
+2012-09-21  Paul Eggert  <address@hidden>
+
+       * trouble.texi (Crashing): Document addr2line.
+
 2012-09-19  Chong Yidong  <address@hidden>
 
        * killing.texi (Yanking): Minor clarification (Bug#12469).

=== modified file 'doc/emacs/trouble.texi'
--- a/doc/emacs/trouble.texi    2012-09-04 18:29:04 +0000
+++ b/doc/emacs/trouble.texi    2012-09-21 19:28:41 +0000
@@ -308,13 +308,26 @@
 
 @noindent
 The number @samp{11} is the system signal number that corresponds to
-the problem, a segmentation fault here.  The hexadecimal program
-addresses can be useful in debugging sessions.  For example, the GDB
-command @samp{list *0x509af6} prints the source-code lines
-corresponding to the @samp{emacs[0x509af6]} entry in the backtrace.
-
-The three dots at the end indicate that Emacs suppressed further
-backtrace entries, in the interest of brevity.
+the problem, a segmentation fault here.  The three dots at the end
+indicate that Emacs suppressed further backtrace entries, in the
+interest of brevity.
+
+The hexadecimal program addresses can be useful in debugging sessions.
+For example, the GDB command @samp{list *0x509af6} prints the
+source-code lines corresponding to the @samp{emacs[0x509af6]} entry in
+the backtrace.  Or, if your system has @command{addr2line}, the
+following shell command outputs a backtrace with source-code line
+numbers:
+
address@hidden
+sed -n 's/.*\[\(.*\)]$/\1/p' @var{backtrace} |
+  addr2line -Cfip -e @var{bindir}/emacs
address@hidden example
+
address@hidden
+Here, @var{backtrace} is the name of a text file containing a copy of
+the backtrace, and @var{bindir} is the name of the directory that
+contains the Emacs executable.
 
 @node After a Crash
 @subsection Recovery After a Crash