diff options
| author | Michael Albinus <michael.albinus@gmx.de> | 2007-07-17 21:29:20 +0000 |
|---|---|---|
| committer | Michael Albinus <michael.albinus@gmx.de> | 2007-07-17 21:29:20 +0000 |
| commit | eab01edba904a8d591bc1a13a4e710492a7bf721 (patch) | |
| tree | f99ad3776fbe50f2c1a82604455f81d6681e873f | |
| parent | ea382aff15872b84f85be389b4118efc6c3412e2 (diff) | |
* files.texi (Magic File Names): Introduce optional parameter
IDENTIFICATION for `file-remote-p'.
| -rw-r--r-- | lispref/ChangeLog | 5 | ||||
| -rw-r--r-- | lispref/files.texi | 9 |
2 files changed, 13 insertions, 1 deletions
diff --git a/lispref/ChangeLog b/lispref/ChangeLog index 5102e72356..5dc45b43b3 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,3 +1,8 @@ +2007-07-17 Michael Albinus <michael.albinus@gmx.de> + + * files.texi (Magic File Names): Introduce optional parameter + IDENTIFICATION for `file-remote-p'. + 2007-07-14 Richard Stallman <rms@gnu.org> * control.texi (Handling Errors): Document `debug' in handler list. diff --git a/lispref/files.texi b/lispref/files.texi index 343a6bc5e3..bfcbe476f9 100644 --- a/lispref/files.texi +++ b/lispref/files.texi @@ -2768,7 +2768,7 @@ nothing and returns @code{nil}. Otherwise it returns the file name of the local copy file. @end defun -@defun file-remote-p filename &optional connected +@defun file-remote-p filename &optional identification 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 @@ -2786,6 +2786,13 @@ 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. +@var{identification} specifies which part of the identifier shall be +returned as string. @var{identification} can be the symbol +@code{method}, @code{user} or @code{host}; any other value is handled +like @code{nil} and means to return the complete identifier string. +In the example above, the remote @code{user} identifier string would +be @code{root}. + 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 |