# HG changeset patch
# User Noah Friedman <friedman@splode.com>
# Date 1117450783 0
# Node ID 1a33c4dbb62b14b4ee80c41e57bb3392ba21e9c0
# Parent  e7e2bd704ba1ea5c4415fb9a86ba904ff73739ed
(After a Crash): Describe how to use emacs-buffer.gdb more explicitly.

diff -r e7e2bd704ba1 -r 1a33c4dbb62b man/trouble.texi
--- a/man/trouble.texi	Mon May 30 10:48:47 2005 +0000
+++ b/man/trouble.texi	Mon May 30 10:59:43 2005 +0000
@@ -351,12 +351,25 @@
 recover are present in Emacs buffers.  You should then save them.  Only
 this---saving them---updates the files themselves.
 
+
   As a last resort, if you had buffers with content which were not
 associated with any files, or if the autosave was not recent enough to
 have recorded important changes, you can use the
-@file{etc/emacs-buffer.gdb} script with @code{gdb} to retrieve them
-from a core dump--provided that a core dump was saved, and that the
-emacs executable was not stripped of its debugging symbols.
+@file{etc/emacs-buffer.gdb} script with GDB (the GNU Debugger) to
+retrieve them from a core dump--provided that a core dump was saved,
+and that the Emacs executable was not stripped of its debugging
+symbols.
+
+  To use this script, run @code{gdb} with the file name of your
+Emacs executable and the file name of the core dump, e.g. @samp{gdb
+/usr/bin/emacs core.emacs}.  At the @code{(gdb)} prompt, load the
+recovery script: @samp{source /usr/src/emacs/etc/emacs-buffer.gdb}.
+You can now use the commands @code{ybuffer-list} and
+@code{ysave-buffer} to list and save buffers.  The @code{ysave-buffer}
+command takes a buffer number (as listed by @code{ybuffer-list}) and a
+file name to which to write the buffer contents.  You should use a
+file name which does not already exist; no backups of the previous
+contents of the file will be saved, if any.
 
 @node Emergency Escape
 @subsection Emergency Escape