From 83ecddd1f5f2809c89e4a415a192e512dae73ff3 Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Mon, 27 Oct 2025 18:45:23 -0500
Subject: feat:which-key: Add descriptive labels for custom keymaps

Enhance which-key integration by providing detailed descriptions for
new key bindings across multiple modules. This improves the
usability of custom keymaps by clarifying the purpose of each
keybinding, making it easier for users to navigate and understand
different menus and options available within the configuration.

This update ensures that all custom keymaps now display a
descriptive label in the which-key popup to explain their
functionality, aiding users in identifying keymap purposes promptly.
---
 modules/org-config.el | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

(limited to 'modules/org-config.el')

diff --git a/modules/org-config.el b/modules/org-config.el
index 0249973f1..753b1092e 100644
--- a/modules/org-config.el
+++ b/modules/org-config.el
@@ -16,7 +16,7 @@
   :init
   (defvar-keymap cj/org-table-map
     :doc "org table operations.")
-  (keymap-global-set "C-c t" cj/org-table-map)
+  (keymap-set cj/custom-keymap "T" cj/org-table-map)
   :bind
   ("C-c c" . org-capture)
   ("C-c a" . org-agenda)
@@ -266,5 +266,20 @@ the current buffer's cache. Useful when encountering parsing errors like
           (message "Cleared org-element cache for current buffer"))
       (user-error "Current buffer is not in org-mode"))))
 
+;; which-key labels for org-table-map
+(with-eval-after-load 'which-key
+  (which-key-add-key-based-replacements
+    "C-; T" "org table menu"
+    "C-; T r" "table row"
+    "C-; T r i" "insert row"
+    "C-; T r d" "delete row"
+    "C-; T c" "table column"
+    "C-; T c i" "insert column"
+    "C-; T c d" "delete column"
+    ;; org global bindings
+    "C-c a" "org agenda"
+    "C-c c" "org capture"
+    "C-c l" "org store link"))
+
 (provide 'org-config)
 ;;; org-config.el ends here
-- 
cgit v1.2.3