changeset 88083:178e852f7ddf

(file-remote-p): Docstring fix.
author Stefan Monnier <monnier@iro.umontreal.ca>
date Wed, 30 Jan 2008 21:25:08 +0000
parents 439a3433552e
children 60aaa6c4ca3c
files lisp/files.el
diffstat 1 files changed, 6 insertions(+), 6 deletions(-) [+]
line wrap: on
line diff
--- a/lisp/files.el	Wed Jan 30 20:43:43 2008 +0000
+++ b/lisp/files.el	Wed Jan 30 21:25:08 2008 +0000
@@ -765,12 +765,12 @@
 
 (defun file-remote-p (file &optional identification connected)
   "Test whether FILE specifies a location on a remote system.
-Return an identification of the system if the location is indeed
-remote.  The identification of the system may comprise a method
-to access the system and its hostname, amongst other things.
-
-For example, the filename \"/user@host:/foo\" specifies a location
-on the system \"/user@host:\".
+Returns nil or a string identifying the remote connection (ideally
+a prefix of FILE).  For example, the remote identification for filename
+\"/user@host:/foo\" could be \"/user@host:\".
+A file is considered \"remote\" if accessing it is likely to be slower or
+less reliable than accessing local files.
+Furthermore, relative file names do not work across remote connections.
 
 IDENTIFICATION specifies which part of the identification shall
 be returned as string.  IDENTIFICATION can be the symbol