[Emacs-diffs] Changes to emacs/lispref/files.texi,v

[Michael Albinus]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Michael Albinus <albinus>       07/07/08 18:08:36

Index: files.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/files.texi,v
retrieving revision 1.111
retrieving revision 1.112
diff -u -b -r1.111 -r1.112
--- files.texi  7 Jul 2007 11:18:31 -0000       1.111
+++ files.texi  8 Jul 2007 18:08:36 -0000       1.112
@@ -2768,7 +2768,7 @@
 of the local copy file.
 @end defun
 
address@hidden file-remote-p filename
address@hidden file-remote-p filename &optional connected
 This function tests whether @var{filename} is a remote file.  If
 @var{filename} is local (not remote), the return value is @code{nil}.
 If @var{filename} is indeed remote, the return value is a string that
@@ -2777,7 +2777,7 @@
 This identifier string can include a host name and a user name, as
 well as characters designating the method used to access the remote
 system.  For example, the remote identifier string for the filename
address@hidden/ssh:user@@host:/some/file} is @code{/ssh:user@@host:}.
address@hidden/sudo::/some/file} is @code{/sudo:root@@localhost:}.
 
 If @code{file-remote-p} returns the same identifier for two different
 filenames, that means they are stored on the same file system and can
@@ -2785,6 +2785,12 @@
 example, that it is possible to start a remote process accessing both
 files at the same time.  Implementors of file handlers need to ensure
 this principle is valid.
+
+The optional parameter @var{connected}, when passed address@hidden,
+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.
 @end defun
 
 @defun unhandled-file-name-directory filename