mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-02 11:21:42 +00:00
Code Issues Releases Activity

(Magic File Names): `file-remote-p' returns an identifier of the

Browse Source 
remote system, not just t.
This commit is contained in:
Kai Großjohann 2004-07-02 14:49:39 +00:00
parent 5fe536b81b
commit 8addb6ebba
2 changed files with 22 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
lispref/ChangeLog
View File

@ -1,3 +1,8 @@
2004-07-02 Kai Grossjohann <kai@emptydomain.de>
* files.texi (Magic File Names): `file-remote-p' returns an
identifier of the remote system, not just t.
2004-07-02 David Kastrup <dak@gnu.org>
* searching.texi (Entire Match Data): Add explanation about new

18
lispref/files.texi
View File

@ -2646,7 +2646,23 @@ of the local copy file.
@end defun
@defun file-remote-p filename
This function returns @code{t} if @var{filename} is a remote file.
This function tests whether @var{filename} is a remote file. The
return value is an identifier of the remote system, if @var{filename}
is indeed remote. Besides the host name, the identifier may comprise
a user name and a method used to access that system.
To illustrate, for the filename @code{/ssh:user@@host:/some/file}, the
identifier is @code{/ssh:user@@host:}.
If @var{filename} is local (not remote), then the return value is
@code{nil}.
If @code{file-remote-p} returns the same identifier for two different
filenames, then the file handler is the same, and also the files can
be accessed locally with respect to each other. This means, for
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.
@end defun
@defun unhandled-file-name-directory filename