[Emacs-diffs] emacs/doc/emacs files.texi

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      08/11/24 20:10:48

Modified files:
        doc/emacs      : files.texi 

Log message:
        (Visiting): Document new behavior of confirm-nonexistent-file-or-buffer.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/files.texi?cvsroot=emacs&r1=1.48&r2=1.49

Patches:
Index: files.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/files.texi,v
retrieving revision 1.48
retrieving revision 1.49
diff -u -b -r1.48 -r1.49
--- files.texi  18 Nov 2008 18:26:08 -0000      1.48
+++ files.texi  24 Nov 2008 20:10:47 -0000      1.49
@@ -240,14 +240,31 @@
 see @ref{Drag and Drop}, and @ref{Misc Dired Features}.
 
 @cindex creating files
+  What if you want to create a new file?  Just visit it.  Emacs
+displays @samp{(New file)} in the echo area, but in other respects
+behaves as if you had visited an existing empty file.  If you make
+changes and save them, the file is created.
+
address@hidden minibuffer confirmation
address@hidden confirming in the minibuffer
+  When you attempt to visit a new file, Emacs might prompt you for
+confirmation first, in case you entered the wrong file name.  Emacs
+asks for confirmation only if the last key you typed in the
+minibuffer, before submitting the input with @key{RET}, was @key{TAB}
+(@code{minibuffer-complete}).  This catches a common mistake, in which
+one types @key{RET} before realizing that @key{TAB} did not complete
+far enough to yield a desired file name (@pxref{Completion}).  Emacs
+asks for confirmation by putting the message @samp{[Confirm]} in the
+minibuffer; type @key{RET} again to confirm and visit the file.
+
 @vindex confirm-nonexistent-file-or-buffer
-  What if you want to create a new file?  Just visit it.
-Emacs prompts you for confirmation before visiting a non-existent
-file, and displays @samp{(New file)} in the echo area, but in other
-respects behaves as if you had visited an existing empty file.  If you
-make changes and save them, the file is created.  If you change the
-variable @code{confirm-nonexistent-file-or-buffer} to @code{nil}, then
-Emacs will not even prompt you for confirmation.
+  The variable @code{confirm-nonexistent-file-or-buffer} controls
+whether Emacs asks for confirmation before visiting a new file.  The
+default value, @code{after-completion}, gives the behavior we have
+just described.  If the value is @code{nil}, Emacs never asks for
+confirmation; for any other address@hidden value, Emacs always asks
+for confirmation.  This variable also affects the
address@hidden command (@pxref{Select Buffer}).
 
 @kindex C-x C-v
 @findex find-alternate-file