From 24474bd34a1c19d86ae2adee247f286e2e702815 Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Tue, 1 Mar 2022 10:47:49 +0000 Subject: users/27536: Improved history list documentation Clarify interaction of matching and numbers. --- ChangeLog | 5 +++++ Doc/Zsh/builtins.yo | 7 ++++--- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index ca8477dfb..6371cb85d 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2022-03-01 Peter Stephenson + + * users/27536: Doc/Zsh/builtins.yo: Clarify interaction of + history matching and numeric indices. + 2022-02-23 Jun-ichi Takimoto * 49766: Completion/Unix/Command/_less: add quotes to -" and -# diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo index c7de50fd6..5649e00d4 100644 --- a/Doc/Zsh/builtins.yo +++ b/Doc/Zsh/builtins.yo @@ -756,15 +756,16 @@ specifies the most recent event beginning with the given string. All substitutions var(old)tt(=)var(new), if any, are then performed on the text of the events. -In addition to the number range, +The range of events selected by numbers can be narrowed further by the +following flags. startsitem() sitem(tt(-I))(restricts to only internal events (not from tt($HISTFILE))) sitem(tt(-L))(restricts to only local events (not from other shells, see tt(SHARE_HISTORY) in ifzman(zmanref(zshoptions))\ ifnzman(noderef(Description of Options)) -- note that tt($HISTFILE) is considered local when read at startup)) -sitem(tt(-m))(takes the first argument as a pattern (should be quoted) and -only the history events matching this pattern are considered) +sitem(tt(-m))(takes the first argument as a pattern (which should be +quoted) and only the history events matching this pattern are considered) endsitem() If var(first) is not specified, it will be set to -1 (the most recent -- cgit 1.4.1