branch: externals/corfu
commit bc989504a5660429dce9949799aafd9c313d752c
Author: Daniel Mendler <m...@daniel-mendler.de>
Commit: Daniel Mendler <m...@daniel-mendler.de>
README: Simplify Orderless-related documentation
See https://github.com/oantolin/orderless/pull/179
---
README.org | 29 +++--------------------------
1 file changed, 3 insertions(+), 26 deletions(-)
diff --git a/README.org b/README.org
index 8674147745..1e68ec8d8d 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
