From 7e352112620ea90d1541d53d10c84d5ce8fc908e Mon Sep 17 00:00:00 2001 From: Daniel Mendler Date: Thu, 3 Feb 2022 21:45:28 +0100 Subject: README: Add short section about auto completion (See #109) --- README.org | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.org b/README.org index e7d3e75..976c128 100644 --- a/README.org +++ b/README.org @@ -134,6 +134,25 @@ want to create your own Capfs, you can find documentation about completion in the [[https://www.gnu.org/software/emacs/manual/html_node/elisp/Completion.html][Elisp manual]]. +** Auto completion + + Auto completion is disabled by default, but can be enabled by setting + ~corfu-auto=t~. Furthermore you may want to configure Corfu to quit completion + eagerly, such that the completion popup stays out of your way when it + appeared unexpectedly. + + #+begin_src emacs-lisp + ;; Enable auto completion and eager quitting + (setq corfu-auto t + corfu-quit-at-boundary t + corfu-quit-no-match t) + #+end_src + + In general, I recommend to experiment a bit with the various settings and key + bindings to find a configuration which works for you. There is no one size + fits all solution. Some people like auto completion, some like manual + completion, some want to cycle with TAB or and some with the arrow keys... + ** Completing with Corfu in the minibuffer Corfu can be used for completion in the minibuffer, since it relies on child -- cgit v1.0