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 716b4b7a50d522d200a03bd741e7247ac6e16294..9aba6006b1bb390bb838d13bf4f6ca97775ff7ac 100644 (file)
--- 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 818875f7a030aa22ff91f1dfc6d02e3e1c2e1a88..e8618152ed9b60a7a1cf43735e6461ced97bd4bf 100644 (file)
--- 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