aboutsummaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
Diffstat (limited to 'README.org')
-rw-r--r--README.org16
1 files changed, 14 insertions, 2 deletions
diff --git a/README.org b/README.org
index 5954e19..b2ffbbe 100644
--- a/README.org
+++ b/README.org
@@ -144,13 +144,25 @@ Pearl writes one active Org file. Running a different query or view replaces tha
*** Command menu
-=M-x pearl-menu= opens a transient dispatcher with commands grouped by fetch, view, issue-at-point, creation, Org sync, and setup. Bind that command if you use Pearl regularly:
+=M-x pearl-menu= opens a transient dispatcher. Ticket actions are grouped as save, edit, new, and delete; workspace actions as fetch, view, and setup. Bind that command if you use Pearl regularly:
#+begin_src emacs-lisp
(global-set-key (kbd "C-c L") #'pearl-menu)
#+end_src
-Every command below is also available directly through =M-x=.
+*** Prefix keymap
+
+For muscle memory, Pearl also defines an opt-in prefix keymap, =pearl-prefix-map=, organized as save / edit / new / delete. It is not bound at load -- a global multi-key prefix isn't reliably free across terminals and GUIs, so you bind it to a prefix that suits your setup. A suggested binding:
+
+#+begin_src emacs-lisp
+ (global-set-key (kbd "C-; L") pearl-prefix-map)
+ ;; or, with use-package:
+ ;; :bind-keymap ("C-; L" . pearl-prefix-map)
+#+end_src
+
+With that prefix, =C-; L s s= saves the ticket at point, =C-; L s a= saves every ticket in the file, =C-; L e p= edits its priority, =C-; L n t= creates a ticket, and =C-; L m= opens the full transient. If you use =which-key=, each step shows a labeled menu.
+
+Every command is also available directly through =M-x=.
*** Fetching and refreshing