From: Jared Finder Date: Sun, 4 Oct 2020 07:01:23 +0000 (-0700) Subject: Updating docs with all special window prefix keys. X-Git-Tag: emacs-27.1.90~90 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=487aae38d4348ff98cfef170f3d08505399d3af0;p=emacs.git 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) --- diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi index aabaec256b4..d70c4d58ba6 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: