[Emacs-diffs] master 4e22083: Minor tweaks in Tramp manual

[Michael Albinus]

branch: master
commit 4e22083bf705285ca9c19949ed678defd6501998
Author: Michael Albinus <address@hidden>
Commit: Michael Albinus <address@hidden>

    Minor tweaks in Tramp manual
    
    * doc/misc/trampver.texi: Add prefixwithspace flag.
    
    * doc/misc/tramp.texi (Password handling): Harmonize example.
    (File name completion): Use prefixwithspace flag.
    (Frequently Asked Questions): Explain `tramp-histfile-override'.
---
 doc/misc/tramp.texi    | 24 ++++++++++++++++++------
 doc/misc/trampver.texi |  2 ++
 2 files changed, 20 insertions(+), 6 deletions(-)

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 38b6371..a42dc6e 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -1507,7 +1507,7 @@ The port can take any @value{tramp} method (@pxref{Inline 
methods},
 file name syntax, must be appended to the machine and login items:
 
 @example
-machine melancholia#4711 port davs login daniel%DOMAIN password geheim
+machine melancholia#4711 port davs login daniel%BIZARRE password geheim
 @end example
 
 @vindex auth-source-debug
@@ -2276,7 +2276,7 @@ in @file{.emacs}.
 @xref{Completion Options, , , emacs}.
 @end ifinfo
 
-For example, type @kbd{C-x C-f @value{prefix}s @key{TAB}},
+For example, type @kbd{C-x C-f @value{prefixwithspace} s @key{TAB}},
 @value{tramp} completion choices show up as
 
 @example
@@ -3160,10 +3160,22 @@ then set them with a hook as follows:
 @item
 Why is @file{~/.sh_history} file on the remote host growing?
 
-Due to @command{ksh} saving tilde expansions triggered by
address@hidden, the history file is probably growing rapidly.  To fix,
-turn off saving history by putting this shell code in the
address@hidden file:
+Due to the remote shell saving tilde expansions triggered by
address@hidden, the history file is probably growing rapidly.
address@hidden can suppress this behaviour with the user option
address@hidden  When set to @code{t}, environment
+variable @env{HISTFILE} is unset, and environment variables
address@hidden @env{HISTSIZE} are set to 0.
+
+Alternatively, @code{tramp-histfile-override} could be a string.
+Environment variable @env{HISTFILE} is set to this file name then.  Be
+careful when setting to @file{/dev/null}; this might result in
+undesired results when using @command{bash} as remote shell.
+
+Another approach is to disable @value{tramp}'s handling of the
address@hidden at all by setting @code{tramp-histfile-override} to
address@hidden  In this case, saving history could be turned off by
+putting this shell code in the @file{.bashrc} or @file{.kshrc} file:
 
 @example
 @group
diff --git a/doc/misc/trampver.texi b/doc/misc/trampver.texi
index 70701aa..f1cb60b 100644
--- a/doc/misc/trampver.texi
+++ b/doc/misc/trampver.texi
@@ -27,6 +27,7 @@
 
 @ifset unified
 @set prefix             /
address@hidden prefixwithspace    /
 @set prefixhop
 @set postfix            :
 @set postfixhop         :
@@ -36,6 +37,7 @@
 
 @ifset separate
 @set prefix             /[
address@hidden prefixwithspace    / [
 @set prefixhop          [
 @set postfix            ]
 @set postfixhop         /