Mercurial > emacs
changeset 105825:da9cc794b4ec
* minibuf.texi (Reading File Names): Note that read-file-name may
use a graphical file dialog.
| author | Chong Yidong <cyd@stupidchicken.com> |
|---|---|
| date | Mon, 02 Nov 2009 02:30:04 +0000 |
| parents | 06f1348e3279 |
| children | 0842ff8d686f |
| files | doc/lispref/ChangeLog doc/lispref/minibuf.texi |
| diffstat | 2 files changed, 18 insertions(+), 3 deletions(-) [+] |
line wrap: on
line diff
--- a/doc/lispref/ChangeLog Mon Nov 02 02:06:36 2009 +0000 +++ b/doc/lispref/ChangeLog Mon Nov 02 02:30:04 2009 +0000 @@ -1,3 +1,8 @@ +2009-11-02 Chong Yidong <cyd@stupidchicken.com> + + * minibuf.texi (Reading File Names): Note that read-file-name may + use a graphical file dialog. + 2009-10-31 Glenn Morris <rgm@gnu.org> * nonascii.texi (User-Chosen Coding Systems): Minor reword. (Bug#4817)
--- a/doc/lispref/minibuf.texi Mon Nov 02 02:06:36 2009 +0000 +++ b/doc/lispref/minibuf.texi Mon Nov 02 02:30:04 2009 +0000 @@ -1337,8 +1337,19 @@ default directory. @defun read-file-name prompt &optional directory default require-match initial predicate -This function reads a file name in the minibuffer, prompting with -@var{prompt} and providing completion. +This function reads a file name, prompting with @var{prompt} and +providing completion. + +As an exception, this function reads a file name using a graphical +file dialog instead of the minibuffer, if (i) it is invoked via a +mouse command, and (ii) the selected frame is on a graphical display +supporting such dialogs, and (iii) the variable @code{use-dialog-box} +is non-@code{nil} (@pxref{Dialog Boxes,, Dialog Boxes, emacs, The GNU +Emacs Manual}), and (iv) the @var{directory} argument, described +below, does not specify a remote file (@pxref{Remote Files,, Remote +Files, emacs, The GNU Emacs Manual}). The exact behavior when using a +graphical file dialog is platform-dependent. Here, we simply document +the behavior when using the minibuffer. The optional argument @var{require-match} has the same meaning as in @code{completing-read}. @xref{Minibuffer Completion}. @@ -1355,7 +1366,6 @@ @var{directory} is also inserted in the minibuffer as initial input. It defaults to the current buffer's value of @code{default-directory}. -@c Emacs 19 feature If you specify @var{initial}, that is an initial file name to insert in the buffer (after @var{directory}, if that is inserted). In this case, point goes at the beginning of @var{initial}. The default for