procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

* tramp.texi (Filename completion): Simplify explanation of

Browse source 
double-slash behaviour.  Explain directory contents flushing.
This commit is contained in:
Michael Albinus 2007-11-18 10:26:50 +00:00
parent b50dd0d2b6
commit b048d47875
2 changed files with 39 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
doc/misc/ChangeLog
View file

@ -1,3 +1,8 @@
2007-11-18 Michael Albinus <michael.albinus@gmx.de>
* tramp.texi (Filename completion): Simplify explanation of
double-slash behaviour. Explain directory contents flushing.
2007-11-16 Jay Belanger <jay.p.belanger@gmail.com>
* calc.texi (TeX and LaTeX Language Modes): Put in

46
doc/misc/tramp.texi
View file

@ -2267,27 +2267,49 @@ filename completion on the remote host. This works pretty much like
for files on the local host, with the exception that minibuffer
killing via a double-slash works only on the filename part, except
that filename part starts with @file{//}.
@ifset emacs
A triple-slash stands for the default behaviour.
@end ifset
@ifinfo
@xref{Minibuffer File, , , @value{emacsdir}}.
@end ifinfo
@noindent
Example:
@example
@ifset emacs
As example, @kbd{@trampfn{telnet, , melancholia, /usr/local/bin//etc}
@key{TAB}} would result in
@file{@trampfn{telnet, , melancholia, /etc}}, whereas
@kbd{@trampfn{telnet, , melancholia, //etc} @key{TAB}} reduces the
minibuffer contents to @file{/etc}. A triple-slash stands for the
default behavior,
i.e. @kbd{@trampfn{telnet, , melancholia, /usr/local/bin///etc}
@key{TAB}} expands directly to @file{/etc}.
@kbd{C-x C-f @trampfn{telnet, , melancholia, /usr/local/bin//etc} @key{TAB}}
@print{} @trampfn{telnet, , melancholia, /etc}
@kbd{C-x C-f @trampfn{telnet, , melancholia, //etc} @key{TAB}}
@print{} /etc
@kbd{C-x C-f @trampfn{telnet, , melancholia, /usr/local/bin///etc} @key{TAB}}
@print{} /etc
@end ifset
@ifset xemacs
As example, @kbd{@trampfn{telnet, , melancholia, /usr/local/bin//}}
would result in @file{@trampfn{telnet, , melancholia, /}}, whereas
@kbd{@trampfn{telnet, , melancholia, //}} expands the minibuffer
contents to @file{/}.
@kbd{C-x C-f @trampfn{telnet, , melancholia, /usr/local/bin//}}
@print{} @trampfn{telnet, , melancholia, /}
@kbd{C-x C-f @trampfn{telnet, , melancholia, //}}
@print{} /
@end ifset
@end example
A remote directory might have changed its contents out of
@value{emacsname} control, for example by creation or deletion of
files by other processes. Therefore, during filename completion the
remote directory contents is reread regularly in order to detect such
changes, which would be invisible otherwise (@pxref{Connection caching}).
@defopt tramp-completion-reread-directory-timeout
This variable defines the number of seconds since last remote command
before rereading a directory contents. A value of 0 would require an
immediate reread during filename completion, @code{nil} means to use
always cached values for the directory contents.
@end defopt
@node Remote processes