* tramp.texi (Connection caching): Host names must be different

when tunneling.

2 files changed, 20 insertions, 1 deletions

diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 1aade36076d..fcb1f0ac651 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,8 @@
+2007-10-29  Michael Albinus  <michael.albinus@gmx.de>
+
+        * tramp.texi (Connection caching): Host names must be different
+        when tunneling.
+
 2007-10-28  Reiner Steib  <Reiner.Steib@gmx.de>
 
         * gnus.texi, gnus-faq.texi, message.texi: Bump version to
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 2e37c2206c9..e208f54b38b 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -1594,6 +1594,20 @@ exiting @value{emacsname}.  You can simply remove this file if
 Using such persistent information can be disabled by setting
 @code{tramp-persistency-file-name} to @code{nil}.
 
+Once consequence of reusing connection related information is that
+@var{tramp} needs to distinguish hosts.  If you, for example, run a
+local @code{sshd} on port 3001, which tunnels @command{ssh} to another
+host, you could access both @file{@trampfn{ssh, , localhost,}} and
+@file{@trampfn{ssh, , localhost#3001,}}.  @var{tramp} would use the
+same host related information (like paths, Perl variants, etc) for
+both connections, although the information is valid only for one of
+them.
+
+In order to avoid trouble, you must use another host name for one of
+the connections, like introducing a @option{Host} section in
+@file{~/.ssh/config} (@pxref{Frequently Asked Questions}) or applying
+multiple hops (@pxref{Multi-hops}).
+
 
 @node Remote Programs
 @section How @value{tramp} finds and uses programs on the remote machine.
@@ -2800,7 +2814,7 @@ Host xy
 
 The file name left to type would be @kbd{C-x C-f @trampfn{ssh, , xy,
 /opt/news/etc}}.  Depending on files in your directories, it is even
-possible to complete the hostname with @kbd{C-x C-f
+possible to complete the host name with @kbd{C-x C-f
 @value{prefix}ssh@value{postfixhop}x @key{TAB}}.
 
 @item Use environment variables: