From: Eli Zaretskii <eliz@gnu.org>
Date: Thu, 13 Aug 2020 13:53:14 +0000 (+0300)
Subject: Improve documentation of special events
X-Git-Tag: emacs-27.1.90~195
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=1c0bc1ccd85615bcc26409ee047513e9e26f108e;p=emacs.git

Improve documentation of special events

* doc/lispref/commands.texi (Misc Events): Explain how to bind
special events to commands.
---

diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index d25f0093618..25f657404f3 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -1845,6 +1845,13 @@ is, after a prefix key---then Emacs reorders the events so that this
 event comes either before or after the multi-event key sequence, not
 within it.
 
+  Some of these special events, such as @code{delete-frame}, invoke
+Emacs commands by default; others are not bound.  If you want to
+arrange for a special event to invoke a command, you can do that via
+@code{special-event-map}.  The command you bind to a function key in
+that map can then examine the full event which invoked it in
+@code{last-input-event}.  @xref{Special Events}.
+
 @node Event Examples
 @subsection Event Examples