about summary refs log tree commit diff
path: root/Doc
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 /Doc
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.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/Zsh/builtins.yo6
-rw-r--r--Doc/Zsh/roadmap.yo4
2 files changed, 9 insertions, 1 deletions
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