[slime-cvs] CVS slime/doc

[CVS User mkoeppe]

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

Modified Files:
	slime.texi 
Log Message:
(Presentations): Add an example that illustrates quoting necessary
with presentations that are lists.


--- /project/slime/cvsroot/slime/doc/slime.texi	2009/12/09 19:33:55	1.87
+++ /project/slime/cvsroot/slime/doc/slime.texi	2009/12/12 18:58:32	1.88
@@ -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/09 19:33:55 $}
+ at set UPDATED @code{$Date: 2009/12/12 18:58:32 $}
 @set TITLE SLIME User Manual
 @settitle @value{TITLE}, version @value{EDITION}
 
@@ -2661,10 +2661,25 @@
 commands, the presentation can be copied to a new input in the REPL:
 
 @example
-CL-USER> (eql '@emph{#<STANDARD-CLASS STANDARD-CLASS>} '@emph{#<STANDARD-CLASS STANDARD-CLASS>})
+CL-USER> (eql '@emph{#<STANDARD-CLASS STANDARD-CLASS>} 
+              '@emph{#<STANDARD-CLASS STANDARD-CLASS>})
 @emph{T}
 @end example
 
+Note that standard evaluation and quoting rules still apply.  So if a
+presentation is a list, it needs to be quoted in an evaluated context to
+avoid treating it as a function call:
+
+ at example
+CL-USER> (list (find-class 'standard-class) 2 3 4)
+ at emph{(#<STANDARD-CLASS STANDARD-CLASS> 2 3 4)}
+CL-USER> @emph{(#<STANDARD-CLASS STANDARD-CLASS> 2 3 4)}
+; Funcall of #<STANDARD-CLASS STANDARD-CLASS> which is a non-function.
+; Evaluation aborted.
+CL-USER> '@emph{(#<STANDARD-CLASS STANDARD-CLASS> 2 3 4)}
+(#<STANDARD-CLASS STANDARD-CLASS> 2 3 4)
+ at end example
+
 When you copy an incomplete presentation or edit the text within a
 presentation, the presentation changes to plain text, losing the
 association with a Lisp object.  In the buffer, this is indicated by