[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs/doc/lispref commands.texi
From: |
Alan Mackenzie |
Subject: |
[Emacs-diffs] emacs/doc/lispref commands.texi |
Date: |
Sun, 22 Mar 2009 15:12:01 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Alan Mackenzie <acmacm> 09/03/22 15:12:01
Modified files:
doc/lispref : commands.texi
Log message:
(Using Interactive): Clarify string argument to `interactive' - even
promptless elements need \n separators.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/commands.texi?cvsroot=emacs&r1=1.14&r2=1.15
Patches:
Index: commands.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/commands.texi,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -b -r1.14 -r1.15
--- commands.texi 7 Feb 2009 11:08:45 -0000 1.14
+++ commands.texi 22 Mar 2009 15:12:01 -0000 1.15
@@ -158,24 +158,22 @@
or more arguments.
@item
-It may be a string; then its contents should consist of a code character
-followed by a prompt (which some code characters use and some ignore).
-The prompt ends either with the end of the string or with a newline.
-Here is a simple example:
+It may be a string; its contents are a sequence of elements separated
+by newlines, one for each address@hidden elements actually
+supply two parameters.}. Each element consists of a code character
+(@pxref{ Interactive Codes}) optionally followed by a prompt (which
+some code characters use and some ignore). Here is an example:
@smallexample
-(interactive "bFrobnicate buffer: ")
+(interactive "P\nbFrobnicate buffer: ")
@end smallexample
@noindent
-The code letter @samp{b} says to read the name of an existing buffer,
-with completion. The buffer name is the sole argument passed to the
-command. The rest of the string is a prompt.
-
-If there is a newline character in the string, it terminates the prompt.
-If the string does not end there, then the rest of the string should
-contain another code character and prompt, specifying another argument.
-You can specify any number of arguments in this way.
+The code letter @samp{P} sets the command's first argument to the raw
+command prefix (@pxref{Prefix Command Arguments}). @samp{bFrobnicate
+buffer: } prompts the user with @samp{Frobnicate buffer: } to enter
+the name of an existing buffer, which becomes the second and final
+argument.
@c Emacs 19 feature
The prompt string can use @samp{%} to include previous argument values
- [Emacs-diffs] emacs/doc/lispref commands.texi,
Alan Mackenzie <=