More documentation

diff --git a/Readme.org b/Readme.org
index 011c8c1c30d6cacabca895397ae598ee3b43d0ec..cc9cd299619f41dba64519e484422e186c225a8b 100644 (file)
--- a/Readme.org
+++ b/Readme.org
@@ -12,6 +12,8 @@ on top of your cursor so you know where it is.
 
 That’s it.
 
+** Customizations
+
 - To customize the appearance of the beacon, configure
   ~beacon-size~ and ~beacon-color~.
 

diff --git a/beacon.el b/beacon.el
index 149f6fbc76dfeddd6cfb3a26c9a3e228fadf89f6..8abafe293e4601047cac7603df419856b9594026 100644 (file)
--- a/beacon.el
+++ b/beacon.el
@@ -23,8 +23,30 @@
 
 ;;; Commentary:
 
-;; This is a global minor-mode.  Turn it on everywhere with
-;;     (beacon-mode 1)
+;; This is a global minor-mode. Turn it on everywhere with:
+;; ┌────
+;; │ (beacon-mode 1)
+;; └────
+;;
+;; Whenever the window scrolls or the buffer changes a light will shine on
+;; top of your cursor so you know where it is.
+;;
+;; That’s it.
+;;
+;;
+;; 1 Customizations
+;; ════════════════
+;;
+;;   • To customize the appearance of the beacon, configure `beacon-size'
+;;     and `beacon-color'.
+;;
+;;   • To customize how long it lasts, configure `beacon-blink-duration'
+;;       and `beacon-blink-delay'.
+;;
+;;   • To customize /when/ it is used at all, configure
+;;     `beacon-blink-when-window-scrolls',
+;;     `beacon-blink-when-buffer-changes', and
+;;     `beacon-blink-when-point-moves'.
 
 ;;; Code: