From b055ec0d85848987d0ba3962c32fb822b292dfd7 Mon Sep 17 00:00:00 2001 From: Noam Postavsky Date: Thu, 8 Aug 2019 19:35:53 -0400 Subject: [PATCH] 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. --- doc/misc/eshell.texi | 12 ++++++++---- etc/NEWS | 2 +- 2 files changed, 9 insertions(+), 5 deletions(-) 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 -- 2.39.2