From ba752d2eb51957b85fa0003732e6e6345ad80668 Mon Sep 17 00:00:00 2001 From: Daniel Shahaf Date: Sat, 13 Jan 2018 16:11:14 +0000 Subject: 42261: docs: Expand documentation of $histchars[1]. Joint with Matthew Martin. --- Doc/Zsh/expn.yo | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) (limited to 'Doc/Zsh/expn.yo') diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo index d5e5838df..1ea6ae47b 100644 --- a/Doc/Zsh/expn.yo +++ b/Doc/Zsh/expn.yo @@ -83,10 +83,11 @@ subsect(Overview) vindex(histchars, use of) A history expansion begins with the first character of the tt(histchars) parameter, which is `tt(!)' by default, and may occur anywhere on the -command line; history expansions do not nest. The `tt(!)' can be escaped -with `tt(\)' or can be enclosed between a pair of single quotes (tt('')) -to suppress its special meaning. Double quotes will em(not) work for -this. Following this history character is an optional event designator +command line, including inside double quotes (but not inside single quotes +tt('...') or C-style quotes tt($'...')). A literal `tt(!)' may be +obtained by escaping it with a backslash. + +The first character is followed by an optional event designator (ifzman(see )noderef(Event Designators)) and then an optional word designator (noderef(Word Designators)); if neither of these designators is present, no history expansion occurs. @@ -96,6 +97,8 @@ but before any other expansions take place and before the command is executed. It is this expanded form that is recorded as the history event for later references. +History expansions do not nest. + By default, a history reference with no event designator refers to the same event as any preceding history reference on that command line; if it is the only history reference in a command, it refers to the previous -- cgit 1.4.1