[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] /srv/bzr/emacs/trunk r110913: Fix bug #12908 with document
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] /srv/bzr/emacs/trunk r110913: Fix bug #12908 with documentation of emacs_backtrace.txt on MS-Windows. |
Date: |
Fri, 16 Nov 2012 20:54:42 +0200 |
User-agent: |
Bazaar (2.5.0) |
------------------------------------------------------------
revno: 110913
fixes bug: http://debbugs.gnu.org/12908
committer: Eli Zaretskii <address@hidden>
branch nick: trunk
timestamp: Fri 2012-11-16 20:54:42 +0200
message:
Fix bug #12908 with documentation of emacs_backtrace.txt on MS-Windows.
doc/emacs/trouble.texi (Crashing): Add information about MS-Windows and
the emacs_backtrace.txt file.
etc/NEWS: Mention emacs_backtrace.txt.
modified:
doc/emacs/ChangeLog
doc/emacs/trouble.texi
etc/NEWS
=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog 2012-11-13 02:25:59 +0000
+++ b/doc/emacs/ChangeLog 2012-11-16 18:54:42 +0000
@@ -1,3 +1,8 @@
+2012-11-16 Eli Zaretskii <address@hidden>
+
+ * trouble.texi (Crashing): Add information about MS-Windows and
+ the emacs_backtrace.txt file. (Bug#12908)
+
2012-11-13 Chong Yidong <address@hidden>
* building.texi (Multithreaded Debugging): gdb-stopped-hooks is
=== modified file 'doc/emacs/trouble.texi'
--- a/doc/emacs/trouble.texi 2012-11-08 10:35:40 +0000
+++ b/doc/emacs/trouble.texi 2012-11-16 18:54:42 +0000
@@ -282,18 +282,23 @@
@subsection When Emacs Crashes
@cindex crash report
address@hidden backtrace
address@hidden @file{emacs_backtrace.txt} file, MS-Windows
Emacs is not supposed to crash, but if it does, it produces a
@dfn{crash report} prior to exiting. The crash report is printed to
the standard error stream. If Emacs was started from a graphical
-desktop, the standard error stream is commonly redirected to a file
-such as @file{~/.xsession-errors}, so you can look for the crash
-report there.
+desktop on a GNU or Unix system, the standard error stream is commonly
+redirected to a file such as @file{~/.xsession-errors}, so you can
+look for the crash report there. On MS-Windows, the crash report is
+written to a file named @file{emacs_backtrace.txt} in the current
+directory of the Emacs process, in addition to the standard error
+stream.
The format of the crash report depends on the platform. On some
platforms, such as those using the GNU C Library, the crash report
includes a @dfn{backtrace} describing the execution state prior to
crashing, which can be used to help debug the crash. Here is an
-example:
+example for a GNU system:
@example
Fatal error 11: Segmentation fault
@@ -320,22 +325,24 @@
@example
sed -n 's/.*\[\(.*\)]$/\1/p' @var{backtrace} |
- addr2line -Cfip -e @var{bindir}/emacs
+ addr2line -Cfip -e @var{bindir}/@var{emacs-binary}
@end example
@noindent
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.
+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.
@cindex core dump
- Optionally, Emacs can generate a @dfn{core dump} when it crashes. A
-core dump is a file containing voluminous data about the state of the
-program prior to the crash, usually examined by loading it into a
-debugger such as GDB. On many platforms, core dumps are disabled by
-default, and you must explicitly enable them by running the shell
-command @samp{ulimit -c unlimited} (e.g.@: in your shell startup
-script).
+ Optionally, Emacs can generate a @dfn{core dump} when it crashes, on
+systems that support core files. A core dump is a file containing
+voluminous data about the state of the program prior to the crash,
+usually examined by loading it into a debugger such as GDB. On many
+platforms, core dumps are disabled by default, and you must explicitly
+enable them by running the shell command @samp{ulimit -c unlimited}
+(e.g.@: in your shell startup script).
@node After a Crash
@subsection Recovery After a Crash
=== modified file 'etc/NEWS'
--- a/etc/NEWS 2012-11-16 17:20:23 +0000
+++ b/etc/NEWS 2012-11-16 18:54:42 +0000
@@ -210,7 +210,9 @@
** Emacs now generates backtraces on fatal errors.
On encountering a fatal error, Emacs now outputs a textual description
of the fatal signal, and a short backtrace on platforms like glibc
-that support backtraces.
+that support backtraces, and also on MS-Windows. On Windows, the
+backtrace is also written to the 'emacs_backtrace.txt' file in the
+directory where Emacs was running.
---
** If your Emacs was built from a bzr checkout, the new variable
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] /srv/bzr/emacs/trunk r110913: Fix bug #12908 with documentation of emacs_backtrace.txt on MS-Windows.,
Eli Zaretskii <=