diff options
| author | Romain Francoise <romain@orebokech.com> | 2005-09-30 18:30:10 +0000 |
|---|---|---|
| committer | Romain Francoise <romain@orebokech.com> | 2005-09-30 18:30:10 +0000 |
| commit | 97c3e4cc37decbf26618ce80b215f1a6aea2a7b8 (patch) | |
| tree | 52f32dad2f4f08d11fe70633f195fc2cb20dbaf2 /lispref | |
| parent | 42b5e85ecd6609f0c35edb9eeb24936b431e940c (diff) | |
| download | emacs-97c3e4cc37decbf26618ce80b215f1a6aea2a7b8.tar.gz | |
(High-Level Completion): Explain that the prompt
given to `read-buffer' should end with a colon and a space.
Update usage examples.
Diffstat (limited to 'lispref')
| -rw-r--r-- | lispref/ChangeLog | 6 | ||||
| -rw-r--r-- | lispref/minibuf.texi | 9 |
2 files changed, 13 insertions, 2 deletions
diff --git a/lispref/ChangeLog b/lispref/ChangeLog index 6e8f20024d2..332ec14df3a 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,3 +1,9 @@ +2005-09-30 Romain Francoise <romain@orebokech.com> + + * minibuf.texi (High-Level Completion): Explain that the prompt + given to `read-buffer' should end with a colon and a space. + Update usage examples. + 2005-09-29 Juri Linkov <juri@jurta.org> * display.texi (Displaying Messages): Rename argument name diff --git a/lispref/minibuf.texi b/lispref/minibuf.texi index 04443c493f3..bc2342fc18e 100644 --- a/lispref/minibuf.texi +++ b/lispref/minibuf.texi @@ -1044,6 +1044,11 @@ return if the user exits with an empty minibuffer. If non-@code{nil}, it should be a string or a buffer. It is mentioned in the prompt, but is not inserted in the minibuffer as initial input. +The argument @var{prompt} should be a string ending with a colon and a +space. If @var{default} is non-@code{nil}, the function inserts it in +@var{prompt} before the colon to follow the convention for reading from +the minibuffer with a default value (@pxref{Programming Tips}). + If @var{existing} is non-@code{nil}, then the name specified must be that of an existing buffer. The usual commands to exit the minibuffer do not exit if the text is not valid, and @key{RET} does completion to @@ -1058,7 +1063,7 @@ only buffer name starting with the given input is @samp{minibuffer.texi}, so that name is the value. @example -(read-buffer "Buffer name? " "foo" t) +(read-buffer "Buffer name: " "foo" t) @group ;; @r{After evaluation of the preceding expression,} ;; @r{the following prompt appears,} @@ -1067,7 +1072,7 @@ only buffer name starting with the given input is @group ---------- Buffer: Minibuffer ---------- -Buffer name? (default foo) @point{} +Buffer name (default foo): @point{} ---------- Buffer: Minibuffer ---------- @end group |