changeset 81772:665f8d0fb99f

(Magic File Names): Rewrite previous change.
author Richard M. Stallman <rms@gnu.org>
date Mon, 09 Jul 2007 14:12:56 +0000
parents 500aec79cf40
children 6bc501ca5958
files lispref/files.texi
diffstat 1 files changed, 4 insertions(+), 5 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/files.texi	Mon Jul 09 12:00:56 2007 +0000
+++ b/lispref/files.texi	Mon Jul 09 14:12:56 2007 +0000
@@ -2786,11 +2786,10 @@
 files at the same time.  Implementors of file handlers need to ensure
 this principle is valid.
 
-The optional parameter @var{connected}, when passed non-@code{nil},
-triggers an additional check whether the remote system has been
-connected already.  The function returns then @code{nil} if there is
-no corresponding open connection, even if @var{filename} is remote.
-This can be used to avoid unnecessary connection attempts.
+If @var{connected} is non-@code{nil}, this function returns @code{nil}
+even if @var{filename} is remote, if Emacs has no network connection
+to its host.  This is useful when you want to avoid the delay of
+making connections when they don't exist.
 @end defun
 
 @defun unhandled-file-name-directory filename