Merge branch 'master' into corfu-update-smart-tab

modules/completion/corfu/README.org

@@ -212,6 +212,14 @@ A few variables may be set to change behavior of this module:
   Whether to prefer navigating org tables over cycling candidates when pressing
   [[kbd:][TAB]] and [[kbd:][S-TAB]].
 
+** Turning off auto-completion
+To disable idle (as-you-type) completion, unset ~corfu-auto~:
+#+begin_src emacs-lisp
+;;; in $DOOMDIR/config.el
+(after! corfu
+  (setq corfu-auto nil))
+#+end_src
+
 ** Adding CAPFs to a mode
 To add other CAPFs on a mode-per-mode basis, put either of the following in your
 ~config.el~:
@@ -242,7 +250,7 @@ all CAPFs are interactive to be called this way, in which case you can use
 * Troubleshooting
 [[doom-report:][Report an issue?]]
 
-** Performance issues with ~cape-dabbrev~
+** Troubleshooting ~cape-dabbrev~
 
 If you have performance issues with ~cape-dabbrev~, the first thing I recommend
 doing is to look at the list of buffers Dabbrev is scanning:
@@ -255,6 +263,22 @@ doing is to look at the list of buffers Dabbrev is scanning:
 ... and modify ~dabbrev-ignored-buffer-regexps~ or ~dabbrev-ignored-buffer-modes~
 accordingly.
 
+If you see garbage completion candidates, you can use the following command to
+debug the issue:
+
+#+begin_src emacs-lisp
+;;;###autoload
+(defun search-in-dabbrev-buffers (search-string)
+  "Search for SEARCH-STRING in all buffers returned by `dabbrev--select-buffers'."
+  (interactive "sSearch string: ")
+  (let ((buffers (dabbrev--select-buffers)))
+    (multi-occur buffers search-string)))
+
+;; Example usage:
+;; Why are these weird characters appearing in my completions?
+(search-in-dabbrev-buffers "\342\200\231")
+#+end_src
+
 ** Fixing TAB Keybindings
 
 If you encounter an issue where your ~TAB~ keybindings are not responding in Doom