diff options
| author | Daniel Mendler <mail@daniel-mendler.de> | 2024-09-04 22:04:38 +0200 |
|---|---|---|
| committer | Daniel Mendler <mail@daniel-mendler.de> | 2024-09-04 22:04:38 +0200 |
| commit | bc989504a5660429dce9949799aafd9c313d752c (patch) | |
| tree | b6656d00fa05947d973ad6d4f0671b2b3baa528a /README.org | |
| parent | 0a616caedf10ebba812a87de3adacd24cd46522b (diff) | |
README: Simplify Orderless-related documentation
See https://github.com/oantolin/orderless/pull/179
Diffstat (limited to 'README.org')
| -rw-r--r-- | README.org | 29 |
1 files changed, 3 insertions, 26 deletions
@@ -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 |
