diff options
author | Eli Zaretskii <eliz@gnu.org> | 2023-05-09 07:52:04 +0300 |
---|---|---|
committer | Eli Zaretskii <eliz@gnu.org> | 2023-05-09 07:52:04 +0300 |
commit | 387ddc0ccc1b21f612b9106bafec63170ede30e6 (patch) | |
tree | ef2e39635872a43b48e5034b3c45fb79be766179 | |
parent | e6b4784a37fb6bfecfa5ee5d84b60fc79c1fc2db (diff) | |
download | emacs-387ddc0ccc1b21f612b9106bafec63170ede30e6.tar.gz |
Improve instructions for dealing with Emacs crashes
* doc/emacs/trouble.texi (Crashing): Show the variant of the
'addr2line' command for MS-Windows.
-rw-r--r-- | doc/emacs/trouble.texi | 34 |
1 files changed, 28 insertions, 6 deletions
diff --git a/doc/emacs/trouble.texi b/doc/emacs/trouble.texi index db78895bb5b..bccdea72b19 100644 --- a/doc/emacs/trouble.texi +++ b/doc/emacs/trouble.texi @@ -314,13 +314,35 @@ sed -n 's/.*\[\(.*\)]$/\1/p' @var{backtrace} | @end example @noindent +On MS-Windows, the backtrace looks somewhat differently, for example: + +@example +Backtrace: +00007ff61166a12e +00007ff611538be1 +00007ff611559601 +00007ff6116ce84a +00007ff9b7977ff0 +@dots{} +@end example + +@noindent +Therefore, the filtering via @command{sed} is not required, and the +command to show the source-code line number is + +@example + addr2line -C -f -i -p -e @var{bindir}/@var{emacs-binary} < @var{backtrace} +@end example + +@noindent Here, @var{backtrace} is the name of a text file containing a copy of -the backtrace, @var{bindir} is the name of the directory that -contains the Emacs executable, and @var{emacs-binary} is the name of -the Emacs executable file, normally @file{emacs} on GNU and Unix -systems and @file{emacs.exe} on MS-Windows and MS-DOS@. Omit the -@option{-p} option if your version of @command{addr2line} is too old -to have it. +the backtrace (on MS-Windows, @file{emacs_backtrace.txt} in the +directory where Emacs was started), @var{bindir} is the name of the +directory that contains the Emacs executable, and @var{emacs-binary} +is the name of the Emacs executable file, normally @file{emacs} on GNU +and Unix systems and @file{emacs.exe} on MS-Windows and MS-DOS@. Omit +the @option{-p} option if your version of @command{addr2line} is too +old to have it. @cindex core dump Optionally, Emacs can generate a @dfn{core dump} when it crashes, on |