* net/tramp-sh.el (tramp-histfile-override): Clarify docstring.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index b658cc1d0fac31c2cf5bbf2cd0250caadf18b6b5..0a76e8136419068d819683a5394fc38f770ea4c5 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2014-12-20  Teodor Zlatanov  <tzz@lifelogs.com>
+
+       * net/tramp-sh.el (tramp-histfile-override): Clarify docstring.
+
 2014-12-19  Artur Malabarba  <bruce.connor.am@gmail.com>
 
        * let-alist.el (let-alist): Enable access to deeper alists by

diff --git a/lisp/net/tramp-sh.el b/lisp/net/tramp-sh.el
index c639af3c230aaa67c518116ad45553467a8c49f9..e4ba762379f5ff27f4c13cb538db798ddc4d52b2 100644 (file)
--- a/lisp/net/tramp-sh.el
+++ b/lisp/net/tramp-sh.el
@@ -66,8 +66,14 @@ files conditionalize this setup based on the TERM environment variable."
 
 ;;;###tramp-autoload
 (defcustom tramp-histfile-override "/dev/null"
-  "Whether the HISTFILE should be overridden to something.  Set
-to nil to disable the override."
+  "When invoking a shell, override the HISTFILE with this value.
+By default, the HISTFILE is set to the \"/dev/null\" value, which
+is special on Unix systems and indicates the shell history should
+not be logged (this avoids clutter due to Tramp commands).
+
+If you set this variable to nil, however, the *override* is
+disabled, so the history will go to the default storage
+location, e.g. \"$HOME/.sh_history\"."
   :group 'tramp
   :type '(choice (const :tag "Do not override HISTFILE" nil)
                  (const :tag "Empty the history (/dev/null)" "/dev/null")