summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJared Finder <jared@finder.org>2020-10-04 00:01:23 -0700
committerEli Zaretskii <eliz@gnu.org>2020-10-31 09:59:16 +0200
commita105db13e11fd15cc72804bf33672122d1c3f2e1 (patch)
treeb484c7d9383f02e7755cda3797cd82f21ca8da09
parent2a6337a6c4dd00fbe00298bcec48a53a6faf87eb (diff)
downloademacs-a105db13e11fd15cc72804bf33672122d1c3f2e1.tar.gz
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.
-rw-r--r--doc/lispref/commands.texi18
1 files changed, 13 insertions, 5 deletions
diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 8959175def8..85bd2c1ed9b 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -2516,8 +2516,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
@@ -2525,9 +2531,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: