summaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
authorDaniel Mendler <mail@daniel-mendler.de>2024-09-04 22:04:38 +0200
committerDaniel Mendler <mail@daniel-mendler.de>2024-09-04 22:04:38 +0200
commitbc989504a5660429dce9949799aafd9c313d752c (patch)
treeb6656d00fa05947d973ad6d4f0671b2b3baa528a /README.org
parent0a616caedf10ebba812a87de3adacd24cd46522b (diff)
README: Simplify Orderless-related documentation
See https://github.com/oantolin/orderless/pull/179
Diffstat (limited to 'README.org')
-rw-r--r--README.org29
1 files changed, 3 insertions, 26 deletions
diff --git a/README.org b/README.org
index 8674147..1e68ec8 100644
--- a/README.org
+++ b/README.org
@@ -172,9 +172,9 @@ completion at point function provided by my [[https://github.com/minad/cape][Cap
#+end_src
If you start to configure Corfu more deeply, I recommend to give the Orderless
-completion style a try for filtering. Orderless completion is different from the
-familiar prefix TAB completion. Note that Orderless is not a necessity; Corfu
-can be used as well with the default completion styles.
+completion style a try for filtering. Orderless completion offers more flexible
+filtering than the default completion styles. Note that Orderless is not a
+necessity; Corfu can be used just as well with the default completion styles.
#+begin_src emacs-lisp
;; Optionally use the `orderless' completion style.
@@ -445,29 +445,6 @@ force snippet expansion, confirm a candidate explicitly with ~RET~.
(global-corfu-mode))
#+end_src
-** Expanding to the common candidate prefix with TAB
-
-If you leave the default configuration of the completion styles, such that the
-~basic~ completion style is still present, then pressing ~M-TAB~ (~corfu-expand~) will
-expand the current input to the common prefix of all completion candidates. In
-contrast, ~TAB~ (~corfu-complete~) behaves differently and expands input to the
-currently selected candidate.
-
-If you use the ~orderless~ completion style, then expansion works differently by
-default. Orderless only expands to single matching candidates, since due to its
-multi-component input, there does not necessarily exist an expansion to a common
-candidate prefix. However it is possible to define a separate ~tab~ completion
-style. The ~tab~ completion style will only take over ~TAB~ completion (if prefix
-expansion is possible), but besides that won't affect Orderless candidate
-filtering.
-
-#+begin_src emacs-lisp
-(add-to-list 'completion-styles-alist
- '(tab completion-basic-try-completion ignore
- "Completion style which provides TAB completion only."))
-(setq completion-styles '(tab orderless basic)))
-#+end_src
-
** Transfer completion to the minibuffer
Sometimes it is useful to transfer the Corfu completion session to the