changeset 85066:875aa6bd4755

* tramp.texi (External packages): New section.
author Michael Albinus <michael.albinus@gmx.de>
date Sat, 06 Oct 2007 11:55:36 +0000
parents 109632907276
children 4636000015c5
files doc/misc/ChangeLog doc/misc/tramp.texi
diffstat 2 files changed, 37 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- 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.
--- 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