mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-15 10:30:25 -08:00
Code Issues Projects Releases Wiki Activity

Adapt file-remote-p doc

Browse source 
* doc/lispref/files.texi (Magic File Names): Adapt file-remote-p.

* lisp/files.el (file-remote-p): Adapt docstring.
This commit is contained in:
Michael Albinus 2024-07-19 18:29:49 +02:00
parent 34c1094e60
commit 0218fb2143
2 changed files with 20 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

16
doc/lispref/files.texi
View file

@ -3624,10 +3624,18 @@ 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}.
@code{method}, @code{user}, @code{host} or @code{localname}; 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 the remote @var{file} does not contain a method, a user name, or a
host name, the respective default value is returned. The string
returned for @var{identification} @code{localname} can differ depending
on whether there is an existing connection. File name handler specific
implementations could support further @var{identification} symbols;
@xref{Top, Tramp, Tramp, tramp}, for example, knows also the @code{hop}
symbol.
If @var{connected} is non-@code{nil}, this function returns @code{nil}
even if @var{filename} is remote, if Emacs has no network connection