From 76ab661df3015f5adc10ff58ba5ea773901753bf Mon Sep 17 00:00:00 2001 From: "Barton E. Schaefer" Date: Mon, 17 Feb 2014 09:57:05 -0800 Subject: unposted: document interactions of "fc -R" etc. with "fc -l" and $HISTCMD --- Doc/Zsh/builtins.yo | 3 +++ Doc/Zsh/params.yo | 7 ++++--- 2 files changed, 7 insertions(+), 3 deletions(-) (limited to 'Doc') diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo index 3c2d5e504..9905ab5ca 100644 --- a/Doc/Zsh/builtins.yo +++ b/Doc/Zsh/builtins.yo @@ -683,6 +683,9 @@ If var(first) is not specified, it will be set to -1 (the most recent event), or to -16 if the tt(-l) flag is given. If var(last) is not specified, it will be set to var(first), or to -1 if the tt(-l) flag is given. +However, if the current event has added entries to the history with +`tt(print -s)' or `tt(fc -R)', then the default var(last) for tt(-l) +includes all new history entries since the current event began. The flag tt(-r) reverses the order of the commands and the flag tt(-n) suppresses command numbers when listing. diff --git a/Doc/Zsh/params.yo b/Doc/Zsh/params.yo index 935fd5d86..cf2ad34d4 100644 --- a/Doc/Zsh/params.yo +++ b/Doc/Zsh/params.yo @@ -599,9 +599,10 @@ group ID by `tt(LPAR()GID=)var(gid)tt(; command+RPAR())' ) vindex(HISTCMD) item(tt(HISTCMD))( -The current history line number in an interactive shell, in other -words the line number for the command that caused tt($HISTCMD) -to be read. +The current history event number in an interactive shell, in other +words the event number for the command that caused tt($HISTCMD) +to be read. If the current history event modifies the history, +tt(HISTCMD) changes to the new maximum history event number. ) vindex(HOST) item(tt(HOST))( -- cgit 1.4.1