]> code.delx.au - gnu-emacs-elpa/blob - Readme.org
Extend doc
[gnu-emacs-elpa] / Readme.org
1 #+TITLE: Beacon --- Never lose your cursor again
2
3 This is a global minor-mode. Turn it on everywhere with:
4 #+BEGIN_SRC emacs-lisp
5 (beacon-mode 1)
6 #+END_SRC
7
8 [[file:example-beacon.gif]]
9
10 Whenever the window scrolls or you switch buffer a light will shine on
11 top of your cursor so you know where it is.
12
13 That’s it.
14
15 ** Customizations
16
17 - The appearance of the beacon is configured by ~beacon-size~ and
18 ~beacon-color~.
19
20 - The duration is configured by ~beacon-blink-duration~ and
21 ~beacon-blink-delay~.
22
23 - To customize /when/ the beacon should blink at all, configure
24 ~beacon-blink-when-window-scrolls~,
25 ~beacon-blink-when-buffer-changes~, and
26 ~beacon-blink-when-point-moves~.
27
28 - To prevent the beacon from blinking only on some major-modes,
29 configure ~beacon-dont-blink-major-modes~. For specific buffers, you
30 can do ~(setq-local beacon-mode nil)~. For even more refined
31 control, configure ~beacon-dont-blink-predicates~
32
33 - Beacon can also push the mark for you whenever point moves a long
34 distance. For this, configure ~beacon-push-mark~.