about summary refs log tree commit diff
diff options
context:
space:
mode:
authorPeter Stephenson <pws@zsh.org>2014-12-17 10:53:13 +0000
committerPeter Stephenson <pws@zsh.org>2014-12-17 10:53:13 +0000
commit4042640eee1c95eb45e3eb773bb55ae556a0208e (patch)
tree158fd93f74ed25ffcc0d3a29fc18f1e0ccf4bf90
parente12b51508277c30530dea85965862ade4ce865d4 (diff)
downloadzsh-4042640eee1c95eb45e3eb773bb55ae556a0208e.tar.gz
zsh-4042640eee1c95eb45e3eb773bb55ae556a0208e.tar.xz
zsh-4042640eee1c95eb45e3eb773bb55ae556a0208e.zip
zsh-users/19551: history documentation.
Note in a couple of places that history file reading and writing
is only done in interactive shells.
-rw-r--r--ChangeLog6
-rw-r--r--Doc/Zsh/builtins.yo6
-rw-r--r--Doc/Zsh/roadmap.yo4
3 files changed, 15 insertions, 1 deletions
diff --git a/ChangeLog b/ChangeLog
index 522ae9768..ee3e8207a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2014-12-17  Peter Stephenson  <p.stephenson@samsung.com>
+
+	* users/19551: Doc/builtins.yo, Doc/Zsh/roadmap.yo: better
+	documentation that history file reading and writing is only
+	done in interactive shells.
+
 2014-12-16  Barton E. Schaefer  <schaefer@zsh.org>
 
 	* Jun Kuriyama: 33984: Src/builtin.c: bin_dirs() should use
diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo
index 446312395..38788d3c4 100644
--- a/Doc/Zsh/builtins.yo
+++ b/Doc/Zsh/builtins.yo
@@ -657,6 +657,12 @@ xitem(tt(      )[ var(old)tt(=)var(new) ... ] [ var(first) [ var(last) ] ])
 xitem(tt(fc) tt(-p) [ tt(-a) ] [ var(filename) [ var(histsize) [ var(savehistsize) ] ] ])
 xitem(tt(fc) tt(-P))
 item(tt(fc) tt(-ARWI) [ var(filename) ])(
+The tt(fc) command controls the interactive history mechanism.  Note
+that reading and writing of history options is only performed if the
+shell is interactive.  Usually this is detected automatically, but
+it can be forced by setting the tt(interactive) option when starting the
+shell.
+
 Select a range of commands from var(first) to var(last) from the
 history list.
 The arguments var(first) and var(last) may be specified as a
diff --git a/Doc/Zsh/roadmap.yo b/Doc/Zsh/roadmap.yo
index ba598e5ea..677848961 100644
--- a/Doc/Zsh/roadmap.yo
+++ b/Doc/Zsh/roadmap.yo
@@ -41,7 +41,9 @@ set appropriate variables, and the number of history lines retained by
 default is quite small (30 lines).  See the description of the shell
 variables (referred to in the documentation as parameters) tt(HISTFILE),
 tt(HISTSIZE) and tt(SAVEHIST) in ifzman(zmanref(zshparam))\
-ifnzman(noderef(Parameters Used By The Shell)).
+ifnzman(noderef(Parameters Used By The Shell)).  Note that it's
+currently only possible to read and write files saving history
+when the shell is interactive, i.e. it does not work from scripts.
 
 The shell now supports the UTF-8 character set (and also others if
 supported by the operating system).  This is (mostly) handled transparently