Add a note how to use `tramp-own-remote-path'

* doc/misc/tramp.texi (Inline methods, External methods)
(Remote shell setup, Android shell setup)
(Frequently Asked Questions, Frequently Asked Questions):
Use @command and @samp consequently.
(Remote programs): The remote shell must support the -l
argument, in order to use `tramp-own-remote-path'.  (Bug#23914)

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index dc3ef23c4558754b7d76e662c1d2b2699e1ecc64..e8c181b22929348d8f6e64be786178a28e2300bc 100644 (file)
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -565,7 +565,7 @@ remote host.
 @command{ssh} can also take extra parameters as port numbers.  For
 example, a host on port 42 is specified as @file{host#42} (the real
 host name, a hash sign, then a port number).  It is the same as passing
 @command{ssh} can also take extra parameters as port numbers.  For
 example, a host on port 42 is specified as @file{host#42} (the real
 host name, a hash sign, then a port number).  It is the same as passing

-@code{-p 42} to the @command{ssh} command.
+@samp{-p 42} to the @command{ssh} command.

 
 @item @option{telnet}
 @cindex method telnet
 
 @item @option{telnet}
 @cindex method telnet


@@ -832,7 +832,7 @@ Since SMB shares end in the @code{$} character, @value{tramp} must use
 substitutions.
 
 When @value{tramp} is not specific about the share name or uses the
 substitutions.
 
 When @value{tramp} is not specific about the share name or uses the

-generic remote directory @code{/}, @command{smbclient} returns all
+generic remote directory @file{/}, @command{smbclient} returns all

 available shares.
 
 Since SMB authentication is based on each SMB share, @value{tramp}
 available shares.
 
 Since SMB authentication is based on each SMB share, @value{tramp}


@@ -1666,13 +1666,16 @@ shown below for @value{tramp} to use when connecting.
 
 Another way to find the remote path is to use the path assigned to the
 remote user by the remote host.  @value{tramp} does not normally retain
 
 Another way to find the remote path is to use the path assigned to the
 remote user by the remote host.  @value{tramp} does not normally retain

-this remote path after logging.  However, @code{tramp-own-remote-path}
+this remote path after login.  However, @code{tramp-own-remote-path}

 preserves the path value, which can be used to update
 @code{tramp-remote-path}.
 
 @lisp
 (add-to-list 'tramp-remote-path 'tramp-own-remote-path)
 @end lisp
 preserves the path value, which can be used to update
 @code{tramp-remote-path}.
 
 @lisp
 (add-to-list 'tramp-remote-path 'tramp-own-remote-path)
 @end lisp

+
+@strong{Note} that this works only if your remote @command{/bin/sh}
+shell supports the login argument @samp{-l}.

 @end defopt
 
 When remote search paths are changed, local @value{tramp} caches must
 @end defopt
 
 When remote search paths are changed, local @value{tramp} caches must


@@ -1864,7 +1867,7 @@ install and execute a listener as follows (see @code{tramp-methods}):
 @end example
 
 The above command-line syntax has changed with @command{busybox}
 @end example
 
 The above command-line syntax has changed with @command{busybox}

-versions.  If @command{nc} refuses the @command{-p} parameter, then
+versions.  If @command{nc} refuses the @samp{-p} parameter, then

 overwrite as follows:
 
 @lisp
 overwrite as follows:
 
 @lisp


@@ -1892,9 +1895,9 @@ Applications such as @code{SSHDroid} that run @command{sshd} process
 on the Android device can accept any @option{ssh}-based methods
 provided these settings are adjusted:
 
 on the Android device can accept any @option{ssh}-based methods
 provided these settings are adjusted:
 

-@code{sh} must be specified for remote shell since Android devices do
-not provide @code{/bin/sh}.  @code{sh} will then invoke whatever shell is
-installed on the device with this setting:
+@command{sh} must be specified for remote shell since Android devices
+do not provide @command{/bin/sh}.  @command{sh} will then invoke
+whatever shell is installed on the device with this setting:

 
 @lisp
 (add-to-list 'tramp-connection-properties
 
 @lisp
 (add-to-list 'tramp-connection-properties


@@ -2870,9 +2873,9 @@ To test if this is the case, open a remote shell and check if the output
 of @command{ls} is in color.
 
 To disable @acronym{ANSI} escape sequences from the remote hosts,
 of @command{ls} is in color.
 
 To disable @acronym{ANSI} escape sequences from the remote hosts,

-disable @option{--color=yes} or @option{--color=auto} in the remote
-host's @file{.bashrc} or @file{.profile}.  Turn this alias on and off
-to see if file name completion works.
+disable @samp{--color=yes} or @samp{--color=auto} in the remote host's
+@file{.bashrc} or @file{.profile}.  Turn this alias on and off to see
+if file name completion works.

 
 @item
 File name completion does not work in directories with large number of
 
 @item
 File name completion does not work in directories with large number of


@@ -2885,7 +2888,7 @@ shell's limit on length of command lines and hang.  @value{tramp} uses
 globbing.
 
 To test if globbing hangs, open a shell on the remote host and then
 globbing.
 
 To test if globbing hangs, open a shell on the remote host and then

-run @samp{ls -d * ..?* > /dev/null}.
+run @command{ls -d * ..?* > /dev/null}.

 
 When testing, ensure the remote shell is the same shell
 (@command{/bin/sh}, @command{ksh} or @command{bash}), that
 
 When testing, ensure the remote shell is the same shell
 (@command{/bin/sh}, @command{ksh} or @command{bash}), that