# HG changeset patch
# User Michael Albinus <michael.albinus@gmx.de>
# Date 1191671736 0
# Node ID 875aa6bd475517594c4cf02235fe70f409550b2d
# Parent  109632907276712b0b6b0ecc90a3a3c852db0f9f
* tramp.texi (External packages): New section.

diff -r 109632907276 -r 875aa6bd4755 doc/misc/ChangeLog
--- a/doc/misc/ChangeLog	Sat Oct 06 11:14:32 2007 +0000
+++ b/doc/misc/ChangeLog	Sat Oct 06 11:55:36 2007 +0000
@@ -1,3 +1,7 @@
+2007-10-06  Michael Albinus  <michael.albinus@gmx.de>
+
+	* tramp.texi (External packages): New section.
+
 2007-09-26  Carsten Dominik  <dominik@science.uva.nl>
 
 	* org.texi: Change links to webpage and maintained email.
diff -r 109632907276 -r 875aa6bd4755 doc/misc/tramp.texi
--- a/doc/misc/tramp.texi	Sat Oct 06 11:14:32 2007 +0000
+++ b/doc/misc/tramp.texi	Sat Oct 06 11:55:36 2007 +0000
@@ -231,6 +231,9 @@
 How file names, directories and localnames are mangled and managed
 
 * Localname deconstruction::    Breaking a localname into its components.
+@ifset emacs
+* External packages::           Integration with external Lisp packages.
+@end ifset
 
 @end detailmenu
 @end menu
@@ -3119,6 +3122,9 @@
 
 @menu
 * Localname deconstruction::    Breaking a localname into its components.
+@ifset emacs
+* External packages::           Integration with external Lisp packages.
+@end ifset
 @end menu
 
 
@@ -3138,6 +3144,33 @@
 effect while preserving the @value{tramp} file name information.
 
 
+@ifset emacs
+@node External packages
+@section 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
+@value{prefix}ssh@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
+@key{TAB}, @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}.
+
+@vindex 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.
+
+@lisp
+(let ((tramp-completion-mode t))
+  ...)
+@end lisp
+@end ifset
+
+
 @node Traces and Profiles
 @chapter How to Customize Traces