Mercurial > emacs
diff lispref/minibuf.texi @ 65758:028c8f536edb
(High-Level Completion): Explain that the prompt
given to `read-buffer' should end with a colon and a space.
Update usage examples.
author | Romain Francoise <romain@orebokech.com> |
---|---|
date | Fri, 30 Sep 2005 18:30:10 +0000 |
parents | e836425ee789 |
children | 448890268bf7 aa89c814f853 |
line wrap: on
line diff
--- a/lispref/minibuf.texi Fri Sep 30 18:29:18 2005 +0000 +++ b/lispref/minibuf.texi Fri Sep 30 18:30:10 2005 +0000 @@ -1044,6 +1044,11 @@ 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 @@ @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 @@ @group ---------- Buffer: Minibuffer ---------- -Buffer name? (default foo) @point{} +Buffer name (default foo): @point{} ---------- Buffer: Minibuffer ---------- @end group