From f113d0c4fdb100ce72ce88b5c8affe497037a5fa Mon Sep 17 00:00:00 2001 From: Michael Albinus Date: Mon, 29 Mar 2021 13:52:01 +0200 Subject: [PATCH] Some Tramp doc clarifications * doc/misc/tramp.texi (Remote shell setup): Explain meaning of `tramp-sh-extra-args' for bash. (Frequently Asked Questions): New item about unloading / reloading Tramp. --- doc/misc/tramp.texi | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 7ae562244e2..5ea0275bafe 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi @@ -2305,6 +2305,8 @@ which support this. This approach has also the advantage, that settings in @code{tramp-sh-extra-args} will be applied. For @command{zsh}, the trouble with the shell prompt due to set zle options will be avoided. +For @command{bash}, loading @file{~/.editrc} or @file{~/.inputrc} is +suppressed. Similar problems can happen with the local shell Tramp uses to create a process. By default, it uses the command @command{/bin/sh} for @@ -5076,6 +5078,24 @@ In case you have installed it from its Git repository, @ref{Recompilation}. @end ifset +@item +I get an error @samp{tramp-file-name-handler: Invalid function: +tramp-compat-with-mutex} + +Likely, you have a running Emacs session with loaded @value{tramp}, +and you try to upgrade it to another version from GNU ELPA. Since +@value{tramp} is not forward compatible, you must unload / reload it. +Try the following steps: + +@example +@kbd{M-x tramp-unload-tramp @key{RET}} +@kbd{M-x load-library @key{RET} tramp @key{RET}} +@end example + +If this doesn't work, you must restart Emacs with proper +@code{load-path} for the new @value{tramp} version. + + @item I get an error @samp{Remote file error: Forbidden reentrant call of Tramp} -- 2.39.2