From: Michael Albinus Date: Tue, 17 Jul 2007 21:29:20 +0000 (+0000) Subject: * files.texi (Magic File Names): Introduce optional parameter X-Git-Tag: emacs-pretest-23.0.90~11861 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=eab01edba904a8d591bc1a13a4e710492a7bf721;p=emacs.git * files.texi (Magic File Names): Introduce optional parameter IDENTIFICATION for `file-remote-p'. --- diff --git a/lispref/ChangeLog b/lispref/ChangeLog index 5102e723566..5dc45b43b33 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,3 +1,8 @@ +2007-07-17 Michael Albinus + + * files.texi (Magic File Names): Introduce optional parameter + IDENTIFICATION for `file-remote-p'. + 2007-07-14 Richard Stallman * control.texi (Handling Errors): Document `debug' in handler list. diff --git a/lispref/files.texi b/lispref/files.texi index 343a6bc5e39..bfcbe476f95 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