[Emacs-diffs] emacs/doc/lispref ChangeLog minibuf.texi

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      09/11/02 02:30:05

Modified files:
        doc/lispref    : ChangeLog minibuf.texi 

Log message:
        * minibuf.texi (Reading File Names): Note that read-file-name may
        use a graphical file dialog.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/ChangeLog?cvsroot=emacs&r1=1.345&r2=1.346
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/minibuf.texi?cvsroot=emacs&r1=1.25&r2=1.26

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/ChangeLog,v
retrieving revision 1.345
retrieving revision 1.346
diff -u -b -r1.345 -r1.346
--- ChangeLog   31 Oct 2009 19:44:02 -0000      1.345
+++ ChangeLog   2 Nov 2009 02:30:04 -0000       1.346
@@ -1,3 +1,8 @@
+2009-11-02  Chong Yidong  <address@hidden>
+
+       * minibuf.texi (Reading File Names): Note that read-file-name may
+       use a graphical file dialog.
+
 2009-10-31  Glenn Morris  <address@hidden>
 
        * nonascii.texi (User-Chosen Coding Systems): Minor reword.  (Bug#4817)

Index: minibuf.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/minibuf.texi,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- minibuf.texi        10 Jul 2009 06:10:51 -0000      1.25
+++ minibuf.texi        2 Nov 2009 02:30:04 -0000       1.26
@@ -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
address@hidden 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 address@hidden (@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}.
 
address@hidden 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