* tramp.texi (Remote processes): Improve eshell example with "su"

and "sudo" commands.

2 files changed, 26 insertions, 0 deletions

diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 7b0a82f5ce7..8fd689af944 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,8 @@
+2009-11-29  Michael Albinus  <michael.albinus@gmx.de>
+
+        * tramp.texi (Remote processes): Improve eshell example with "su"
+        and "sudo" commands.
+
 2009-11-28  Chong Yidong  <cyd@stupidchicken.com>
 
         * semantic.texi (Analyzer Internals): Rename from Analyzer.
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 2c48fe32c55..f0c0b6a3924 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -2584,6 +2584,27 @@ uid=0(root) gid=0(root) groups=0(root)
 @b{@trampfn{sudo, root, host, /etc} $}
 @end example
 
+@ifset emacs
+Since @value{emacsname} 23.2, @code{eshell} has also an own
+implementation of the @code{su} and @code{sudo} commands.  Both
+commands change the default directory of the @file{*eshell*} buffer to
+the value related to the user the command has switched to.  This works
+even on remote hosts, adding silently a corresponding entry to the
+variable @code{tramp-default-proxies-alist} (@pxref{Multi-hops}):
+
+@example
+@b{~ $} cd @trampfn{ssh, user, remotehost, /etc} @key{RET}
+@b{@trampfn{ssh, user, remotehost, /etc} $} find-file shadow
+File is not readable: @trampfn{ssh, user, remotehost, /etc/shadow}
+@b{@trampfn{ssh, user, remotehost, /etc} $} sudo find-file shadow
+#<buffer shadow>
+@b{@trampfn{ssh, user, remotehost, /etc} $} su - @key{RET}
+@b{@trampfn{su, root, remotehost, /root} $} id @key{RET}
+uid=0(root) gid=0(root) groups=0(root)
+@b{@trampfn{su, root, remotehost, /root} $}
+@end example
+@end ifset
+
 
 @anchor{Running a debugger on a remote host}
 @subsection Running a debugger on a remote host