From 4042640eee1c95eb45e3eb773bb55ae556a0208e Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Wed, 17 Dec 2014 10:53:13 +0000 Subject: zsh-users/19551: history documentation. Note in a couple of places that history file reading and writing is only done in interactive shells. --- ChangeLog | 6 ++++++ Doc/Zsh/builtins.yo | 6 ++++++ Doc/Zsh/roadmap.yo | 4 +++- 3 files changed, 15 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index 522ae9768..ee3e8207a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2014-12-17 Peter Stephenson + + * 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 * 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 -- cgit 1.4.1