42261: docs: Expand documentation of $histchars[1]. Joint with Matthew Martin.

1 files changed, 7 insertions, 4 deletions

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