[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
emacs-27 487aae3 1/2: Updating docs with all special window prefix keys.
From: |
Eli Zaretskii |
Subject: |
emacs-27 487aae3 1/2: Updating docs with all special window prefix keys. |
Date: |
Sat, 31 Oct 2020 04:05:05 -0400 (EDT) |
branch: emacs-27
commit 487aae38d4348ff98cfef170f3d08505399d3af0
Author: Jared Finder <jared@finder.org>
Commit: Eli Zaretskii <eliz@gnu.org>
Updating docs with all special window prefix keys.
* doc/lispref/commands.texi (Key Sequence Input): Add documentation for
missing special window areas. Explicitly call out window or frame.
(cherry picked from commit a105db13e11fd15cc72804bf33672122d1c3f2e1)
---
doc/lispref/commands.texi | 18 +++++++++++++-----
1 file changed, 13 insertions(+), 5 deletions(-)
diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index aabaec2..d70c4d5 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -2517,8 +2517,14 @@ with any other events.
@cindex @code{vertical-scroll-bar} prefix key
@cindex @code{menu-bar} prefix key
@cindex @code{tab-bar} prefix key
-@cindex mouse events, in special parts of frame
-When mouse events occur in special parts of a window, such as a mode
+@cindex @code{left-margin} prefix key
+@cindex @code{right-margin} prefix key
+@cindex @code{left-fringe} prefix key
+@cindex @code{right-fringe} prefix key
+@cindex @code{right-divider} prefix key
+@cindex @code{bottom-divider} prefix key
+@cindex mouse events, in special parts of window or frame
+When mouse events occur in special parts of a window or frame, such as a mode
line or a scroll bar, the event type shows nothing special---it is the
same symbol that would normally represent that combination of mouse
button and modifier keys. The information about the window part is kept
@@ -2526,9 +2532,11 @@ elsewhere in the event---in the coordinates. But
@code{read-key-sequence} translates this information into imaginary
prefix keys, all of which are symbols: @code{tab-line}, @code{header-line},
@code{horizontal-scroll-bar}, @code{menu-bar}, @code{tab-bar},
@code{mode-line},
-@code{vertical-line}, and @code{vertical-scroll-bar}. You can define
-meanings for mouse clicks in special window parts by defining key
-sequences using these imaginary prefix keys.
+@code{vertical-line}, @code{vertical-scroll-bar}, @code{left-margin},
+@code{right-margin}, @code{left-fringe}, @code{right-fringe},
+@code{right-divider}, and @code{bottom-divider}. You can define meanings for
+mouse clicks in special window parts by defining key sequences using these
+imaginary prefix keys.
For example, if you call @code{read-key-sequence} and then click the
mouse on the window's mode line, you get two events, like this: