[Emacs-diffs] /srv/bzr/emacs/emacs-24 r110814: * doc/emacs/trouble.texi (Crashing): Copyedits.

[Chong Yidong]

------------------------------------------------------------
revno: 110814
committer: Chong Yidong <address@hidden>
branch nick: emacs-24
timestamp: Thu 2012-11-08 18:35:40 +0800
message:
  * doc/emacs/trouble.texi (Crashing): Copyedits.
modified:
  doc/emacs/ChangeLog
  doc/emacs/trouble.texi
  etc/NEWS

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2012-11-08 08:14:23 +0000
+++ b/doc/emacs/ChangeLog       2012-11-08 10:35:40 +0000
@@ -1,3 +1,7 @@
+2012-11-08  Chong Yidong  <address@hidden>
+
+       * trouble.texi (Crashing): Copyedits.
+
 2012-11-08  Glenn Morris  <address@hidden>
 
        * files.texi (Diff Mode): Trailing whitespace updates.

=== modified file 'doc/emacs/trouble.texi'
--- a/doc/emacs/trouble.texi    2012-11-07 06:54:43 +0000
+++ b/doc/emacs/trouble.texi    2012-11-08 10:35:40 +0000
@@ -281,18 +281,19 @@
 @node Crashing
 @subsection When Emacs Crashes
 
-  Emacs is not supposed to crash, but if it does, before it exits it
-reports a brief summary  of the crash to the standard error stream
address@hidden  If enabled, a crashed Emacs also generates a core dump
-containing voluminous data about the crash.  On many platforms you can
-enable core dumps by putting the shell command @samp{ulimit -c unlimited}
-into your shell startup script.  The crash report and core dump can be
-used when debugging the same version of Emacs on the same platform.
address@hidden crash report
+  Emacs is not supposed to crash, but if it does, it produces a
address@hidden 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.
 
-The format of the crash report depends on the platform, and some
-platforms support backtraces.
-Here is an example, generated on x86-64 GNU/Linux with version 2.15 of
-the GNU C Library:
+  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
 Fatal error 11: Segmentation fault
@@ -304,25 +305,18 @@
 /lib64/libpthread.so.0(read+0xe)[0x375220e08e]
 emacs[0x509af6]
 emacs[0x5acc26]
-emacs[0x5adbfb]
-emacs[0x56566b]
-emacs[0x59bac3]
-emacs[0x565151]
-...
address@hidden
 @end example
 
 @noindent
-The number @samp{11} is the system signal number that corresponds to
-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:
+The number @samp{11} is the system signal number corresponding to the
+crash---in this case a segmentation fault.  The hexadecimal numbers
+are program addresses, which can be associated with source code lines
+using a debugging tool.  For example, the GDB command
address@hidden *0x509af6} prints the source-code lines corresponding to
+the @samp{emacs[0x509af6]} entry.  If your system has the
address@hidden utility, the following shell command outputs a
+backtrace with source-code line numbers:
 
 @example
 sed -n 's/.*\[\(.*\)]$/\1/p' @var{backtrace} |
@@ -334,6 +328,15 @@
 the backtrace, and @var{bindir} is the name of the directory that
 contains the Emacs executable.
 
address@hidden 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).
+
 @node After a Crash
 @subsection Recovery After a Crash
 

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-11-08 08:14:23 +0000
+++ b/etc/NEWS  2012-11-08 10:35:40 +0000
@@ -164,6 +164,7 @@
 ** `C-x C-q' is now bound to the new minor mode `read-only-mode'.
 This minor mode replaces `toggle-read-only', which is now obsolete.
 
++++
 ** 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