[Emacs-diffs] /srv/bzr/emacs/trunk r103652: * tramp.texi (Remote processes): New subsection "Running shell on

[Michael Albinus]

------------------------------------------------------------
revno: 103652
committer: Michael Albinus <address@hidden>
branch nick: trunk
timestamp: Mon 2011-03-14 17:39:58 +0100
message:
  * tramp.texi (Remote processes): New subsection "Running shell on
  a remote host".
modified:
  doc/misc/ChangeLog
  doc/misc/tramp.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2011-03-13 04:07:38 +0000
+++ b/doc/misc/ChangeLog        2011-03-14 16:39:58 +0000
@@ -1,3 +1,8 @@
+2011-03-14  Michael Albinus <address@hidden>
+
+       * tramp.texi (Remote processes): New subsection "Running shell on
+       a remote host".
+
 2011-03-12  Teodor Zlatanov  <address@hidden>
 
        * auth.texi (Help for developers): Update docs to explain that the

=== modified file 'doc/misc/tramp.texi'
--- a/doc/misc/tramp.texi       2011-03-12 19:19:47 +0000
+++ b/doc/misc/tramp.texi       2011-03-14 16:39:58 +0000
@@ -2540,7 +2540,28 @@
 that host.
 
 
address@hidden Running shell-command on a remote host
address@hidden Running @code{shell} on a remote host
address@hidden shell
+
+Calling @code{M-x shell} in a buffer related to a remote host runs the
+local shell as defined in @option{shell-file-name}.  This might be
+also a valid path name for a shell to be applied on the remote host,
+but it will fail at least when your local and remote hosts belong to
+different system types, like @samp{windows-nt} and @samp{gnu/linux}.
+
+You must set the variable @option{explicit-shell-file-name} to the
+shell path name on the remote host, in order to start that shell on
+the remote host.
+
address@hidden emacs
+Starting with Emacs 24 this won't be necessary, if you call
address@hidden interactively.  You will be asked for the remote shell
+path, if you are on a remote buffer, and if
address@hidden is equal to @code{nil}.
address@hidden ifset
+
+
address@hidden Running @code{shell-command} on a remote host
 @cindex shell-command
 
 @code{shell-command} allows to execute commands in a shell, either
@@ -2556,13 +2577,13 @@
 continuous output of the @command{tail} command.
 
 
address@hidden Running eshell on a remote host
address@hidden Running @code{eshell} on a remote host
 @cindex eshell
 
 @value{tramp} is integrated into @file{eshell.el}.  That is, you can
 open an interactive shell on your remote host, and run commands there.
-After you have started @code{eshell}, you could perform commands like
-this:
+After you have started @code{M-x eshell}, you could perform commands
+like this:
 
 @example
 @b{~ $} cd @trampfn{sudo, , , /etc} @key{RET}