[slime-cvs] CVS slime/doc

[CVS User trittweiler]

Update of /project/slime/cvsroot/slime/doc
In directory cl-net:/tmp/cvs-serv2759/doc

Modified Files:
	slime.texi 
Log Message:
	* swank.lisp (*sldb-quit-restart*): Export. For users to customize
	what `q' does in SLDB.
	(handle-requests): Test differently for recursive invocations
	as *sldb-quit-restart* may now be globally bound due to user
	customization.
	(coerce-restart): Coerces a restart-designator to a restart.
	(throw-to-toplevel): Use it.

	* slime.texi (swank:*sldb-quit-restart*): Document it.


--- /project/slime/cvsroot/slime/doc/slime.texi	2009/12/15 17:12:42	1.90
+++ /project/slime/cvsroot/slime/doc/slime.texi	2009/12/16 09:24:11	1.91
@@ -12,7 +12,7 @@
 @set EDITION 3.0-alpha
 @set SLIMEVER 3.0-alpha
 @c @set UPDATED @today{}
- at set UPDATED @code{$Date: 2009/12/15 17:12:42 $}
+ at set UPDATED @code{$Date: 2009/12/16 09:24:11 $}
 @set TITLE SLIME User Manual
 @settitle @value{TITLE}, version @value{EDITION}
 
@@ -1396,9 +1396,11 @@
 @kbditem{a, sldb-abort}
 Invoke the @code{ABORT} restart.
 
+ at anchor{sldb-quit}
 @kbditem{q, sldb-quit}
-``Quit'' -- @code{THROW} to a tag that the top-level @SLIME{}
-request-loop catches.
+``Quit'' -- For @SLIME{} evaluation requests, invoke a restart which
+restores to a known program state. For errors in other threads, see
+ at ref{SWANK:*SLDB-QUIT-RESTART*}.
 
 @kbditem{c, sldb-continue}
 Invoke the @code{CONTINUE} restart.
@@ -1832,11 +1834,26 @@
 to handle all debugging in the Lisp image. This is for debugging
 multithreaded and callback-driven applications.
 
- at vindex SWANK:*SLDB-PRINTER-BINDINGS*
+ at anchor{SWANK:*SLDB-QUIT-RESTART*}
+ at vindex SWANK:*SLDB-QUIT-RESTART*
+ at item SWANK:*SLDB-QUIT-RESTART*
+This variable names the restart that is invoked when pressing @kbd{q}
+(@pxref{sldb-quit}) in @SLDB{}. For @SLIME{} evaluation requests this
+is @emph{unconditionally} bound to a restart that returns to a safe
+point. This variable is supposed to customize what @kbd{q} does if an
+application's thread lands into the debuggger (see
+ at code{SWANK:*GLOBAL-DEBUGGER*}).
+ at example
+(setf swank:*sldb-quit-restart* 'sb-thread:terminate-thread)
+ at end example
+
+ at vindex SWANK:*BACKTRACE-PRINTER-BINDINGS*
 @vindex SWANK:*MACROEXPAND-PRINTER-BINDINGS*
+ at vindex SWANK:*SLDB-PRINTER-BINDINGS*
 @vindex SWANK:*SWANK-PPRINT-BINDINGS*
- at item SWANK:*SLDB-PRINTER-BINDINGS*
+ at item SWANK:*BACKTRACE-PRINTER-BINDINGS*
 @itemx SWANK:*MACROEXPAND-PRINTER-BINDINGS*
+ at itemx SWANK:*SLDB-PRINTER-BINDINGS*
 @itemx SWANK:*SWANK-PPRINT-BINDINGS*
 These variables can be used to customize the printer in various
 situations.  The values of the variables are association lists of