[Emacs-diffs] Changes to emacs/doc/misc/tramp.texi,v

[Michael Albinus]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Michael Albinus <albinus>       07/10/06 11:55:36

Index: tramp.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/tramp.texi,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -b -r1.3 -r1.4
--- tramp.texi  14 Sep 2007 04:18:52 -0000      1.3
+++ tramp.texi  6 Oct 2007 11:55:36 -0000       1.4
@@ -231,6 +231,9 @@
 How file names, directories and localnames are mangled and managed
 
 * Localname deconstruction::    Breaking a localname into its components.
address@hidden emacs
+* External packages::           Integration with external Lisp packages.
address@hidden ifset
 
 @end detailmenu
 @end menu
@@ -3119,6 +3122,9 @@
 
 @menu
 * Localname deconstruction::    Breaking a localname into its components.
address@hidden emacs
+* External packages::           Integration with external Lisp packages.
address@hidden ifset
 @end menu
 
 
@@ -3138,6 +3144,33 @@
 effect while preserving the @value{tramp} file name information.
 
 
address@hidden emacs
address@hidden External packages
address@hidden Integration with external Lisp packages.
+
+While reading filenames in the minibuffer, @value{tramp} must decide
+whether it completes possible incomplete filenames, or not.  Imagine
+there is the following situation: You have typed @kbd{C-x C-f
address@hidden@value{postfixhop} @key{TAB}}.  @value{tramp} cannot
+know, whether @option{ssh} is a method or a host name.  It checks
+therefore the last input character you have typed.  If this is
address@hidden, @key{SPACE} or @kbd{?}, @value{tramp} assumes that you are
+still in filename completion, and it does not connect to the possible
+remote host @option{ssh}.
+
address@hidden tramp-completion-mode
+External packages, which use other characters for completing filenames
+in the minibuffer, must signal this to @value{tramp}.  For this case,
+the variable @code{tramp-completion-mode} can be bound temporarily to
+a non-nil value.
+
address@hidden
+(let ((tramp-completion-mode t))
+  ...)
address@hidden lisp
address@hidden ifset
+
+
 @node Traces and Profiles
 @chapter How to Customize Traces