From: Noam Postavsky Date: Thu, 8 Aug 2019 23:35:53 +0000 (-0400) Subject: Say how to enable event designators in the eshell manual X-Git-Tag: emacs-27.0.90~1666 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=b055ec0d85848987d0ba3962c32fb822b292dfd7;p=emacs.git Say how to enable event designators in the eshell manual * doc/misc/eshell.texi (History): Mention that event designators need to be enabled. * etc/NEWS: Mark corresponding entry as documented in manual. --- diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi index 716b4b7a50d..9aba6006b1b 100644 --- a/doc/misc/eshell.texi +++ b/doc/misc/eshell.texi @@ -462,10 +462,14 @@ The n-th entry of the history ring can be applied with the @samp{!n} command. If @code{n} is negative, the entry is counted from the end of the history ring. -@samp{!foo} expands to the last command beginning with @code{foo}, and -@samp{!?foo} to the last command containing @code{foo}. The n-th -argument of the last command beginning with @code{foo} is accessible -by @code{!foo:n}. +@cindex event designators +@findex eshell-expand-history-references +When history event designators are enabled (by adding +@code{eshell-expand-history-references} to +@code{eshell-expand-input-functions}), @samp{!foo} expands to the last +command beginning with @code{foo}, and @samp{!?foo} to the last +command containing @code{foo}. The n-th argument of the last command +beginning with @code{foo} is accessible by @code{!foo:n}. The history ring is loaded from a file at the start of every session, and written back to the file at the end of every session. The file path diff --git a/etc/NEWS b/etc/NEWS index 818875f7a03..e8618152ed9 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -1346,7 +1346,7 @@ default, and not just the opening element. behave similarly, e.g. Pcomplete's default cycling can be obtained with '(setq completion-cycle-threshold 5)'. ---- ++++ *** Expansion of history event designators is disabled by default. To restore the old behavior, use