From 0d30ef188abecdfd19ef144c0bc6311943563c18 Mon Sep 17 00:00:00 2001
From: Christian Packard <6462409+cpackard@users.noreply.github.com>
Date: Mon, 24 Jul 2023 17:22:32 -0400
Subject: [PATCH] docs(lispy): add "Working with Brackets"

---
 modules/editor/lispy/README.org | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/modules/editor/lispy/README.org b/modules/editor/lispy/README.org
index 008ec6f39..03a323f6e 100644
--- a/modules/editor/lispy/README.org
+++ b/modules/editor/lispy/README.org
@@ -68,6 +68,27 @@ To change the key themes set ~lispyville-key-theme~. Think of
 lispyville's [[https://github.com/noctuid/lispyville/blob/master/README.org][README]] for more info on the specific keybindings of each key theme
 (starting [[https://github.com/noctuid/lispyville#operators-key-theme][here]]).
 
+** Working with Brackets
+
+By default, =[= and =]= are [[https://github.com/noctuid/lispyville/tree/master#additional-movement-key-theme][bound]] to =lispyville-previous-opening= and
+=lispyville-next-closing= respectively. If you use a language which makes frequent
+use of brackets (e.g. Clojure, Racket, Scheme), you can insert a bracket pair =[]=
+by typing ={=. If you prefer to use the bracket keys for input, you can rebind
+them like below:
+
+#+begin_src emacs-lisp
+;; in $DOOMDIR/config.el
+
+(map! :after (lispy lispyville)
+      :map lispy-mode-map-lispy
+      ;; unbind individual bracket keys
+      "[" nil
+      "]" nil
+      ;; re-bind commands bound to bracket keys by default
+      "M-[" #'lispyville-previous-opening
+      "M-]" #'lispyville.next-opening)
+#+end_src
+
 * Troubleshooting
 [[doom-report:][Report an issue?]]