[Emacs-diffs] master 98a5958 2/3: Explain ad-hoc multi-hop in the Tramp Quick Start Guide

[Michael Albinus]

branch: master
commit 98a5958f77f56c3de529fe04d3f1c85c037f49e6
Author: Michael Albinus <address@hidden>
Commit: Michael Albinus <address@hidden>

    Explain ad-hoc multi-hop in the Tramp Quick Start Guide
    
    * doc/misc/tramp.texi (Quick Start Guide): New section "Combining
    @option{ssh} or @option{plink} with @option{su} or @option{sudo}".
---
 doc/misc/tramp.texi | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 3dfd522..b272c38 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -467,6 +467,27 @@ The method @option{sg} stands for ``switch group''; the 
changed group
 must be used here as user name.  The default host name is the same.
 
 
address@hidden Start Guide: @option{ssh}, @option{plink}, @option{su}, 
@option{sudo} and @option{sg} methods}
address@hidden Combining @option{ssh} or @option{plink} with @option{su} or 
@option{sudo}
address@hidden method @option{ssh}
address@hidden @option{ssh} method
address@hidden method @option{plink}
address@hidden @option{plink} method
address@hidden method @option{su}
address@hidden @option{su} method
address@hidden method @option{sudo}
address@hidden @option{sudo} method
+
+If the @option{su} or @option{sudo} option shall be performed on
+another host, it could be comnbined with a leading @option{ssh} or
address@hidden option.  That means, @value{tramp} connects first to
+the other host with non-administrative credentials, and changes to
+administrative credentials on that host afterwards.  In a simple case,
+the syntax looks like
address@hidden@address@hidden@@host|address@hidden@value{postfix}/path/to/file}.
address@hidden multi-hops}.
+
+
 @anchor{Quick Start Guide: @option{sudoedit} method}
 @section Using @command{sudoedit}
 @cindex method @option{sudoedit}