[slime-cvs] CVS update: slime/doc/slime.texi

[Matthias Koeppe]

Update of /project/slime/cvsroot/slime/doc
In directory common-lisp.net:/tmp/cvs-serv6114

Modified Files:
	slime.texi 
Log Message:
(Programming Helpers): Document C-c C-s, slime-complete-form.

Date: Sat Aug  6 16:45:31 2005
Author: mkoeppe

Index: slime/doc/slime.texi
diff -u slime/doc/slime.texi:1.40 slime/doc/slime.texi:1.41
--- slime/doc/slime.texi:1.40	Fri Jul 29 14:40:51 2005
+++ slime/doc/slime.texi	Sat Aug  6 16:45:31 2005
@@ -46,7 +46,7 @@
 @end macro
 
 @set EDITION 1.2
- at set UPDATED @code{$Date: 2005/07/29 12:40:51 $}
+ at set UPDATED @code{$Date: 2005/08/06 14:45:31 $}
 
 @titlepage
 @title SLIME User Manual
@@ -640,9 +640,33 @@
 The space key inserts a space and also looks up and displays the
 argument list for the function at point, if there is one.
 
- at kbditem{C-c C-s, slime-insert-arglist}
+ at kbditem{C-c C-s, slime-complete-form} 
 Looks up and inserts into the current buffer the argument list for the
-function at point, if there is one.
+function at point, if there is one.  More generally, the command
+completes an incomplete form with a template for the missing arguments.
+There is special code for discovering extra keywords of generic
+functions and for handling @code{make-instance} and
+ at code{defmethod}. Examples:
+
+ at example
+(subseq "abc" <C-c C-s>
+  --inserts--> start [end])
+(find 17 <C-c C-s>
+  --inserts--> sequence :from-end from-end :test test
+               :test-not test-not :start start :end end 
+               :key key)
+(find 17 '(17 18 19) :test #'= <C-c C-s>
+  --inserts--> :from-end from-end
+               :test-not test-not :start start :end end 
+               :key key)
+(defclass foo () ((bar :initarg :bar)))
+(defmethod print-object <C-c C-s>
+  --inserts-->   (object stream)
+               body...)
+(defmethod initialize-instance :after ((object foo) &key blub))
+(make-instance 'foo <C-c C-s>
+  --inserts--> :bar bar :blub blub initargs...)
+ at end example
 
 @kbditem{C-c C-m, slime-macroexpand-1}
 Macroexpand the expression at point once.  If invoked with a prefix