From 3fca979f6ee9d9973290e08eb38bfa4727284bc7 Mon Sep 17 00:00:00 2001 From: Daniel Mendler Date: Wed, 6 Apr 2022 08:15:15 +0200 Subject: Use (orderless basic) as completion-styles (Fix #111) --- README.org | 25 +++++++++++++++---------- orderless.texi | 25 +++++++++++++++---------- 2 files changed, 30 insertions(+), 20 deletions(-) diff --git a/README.org b/README.org index a508bef..4d19f7f 100644 --- a/README.org +++ b/README.org @@ -62,7 +62,7 @@ If you use ELPA or MELPA, the easiest way to install =orderless= is via #+begin_src emacs-lisp (use-package orderless :ensure t - :custom (completion-styles '(orderless))) + :custom (completion-styles '(orderless basic))) #+end_src Alternatively, put =orderless.el= somewhere on your =load-path=, and use @@ -70,9 +70,14 @@ the following configuration: #+begin_src emacs-lisp (require 'orderless) -(setq completion-styles '(orderless)) +(setq completion-styles '(orderless basic)) #+end_src +The =basic= completion style is specified as fallback in addition to +=orderless= in order to ensure that completion commands which rely on +dynamic completion tables, e.g., ~completion-table-dynamic~ or +~completion-table-in-turn~, work correctly. + Bug reports are highly welcome and appreciated! :CONTENTS: @@ -407,7 +412,7 @@ install Helm and configure Icomplete to use it as follows: #+begin_src emacs-lisp (require 'helm) - (setq completion-styles '(helm)) + (setq completion-styles '(helm basic)) (icomplete-mode) #+end_src @@ -417,13 +422,13 @@ install Helm and configure Icomplete to use it as follows: ** Prescient The [[https://github.com/raxod502/prescient.el][prescient.el]] library also provides matching of space-separated -components in any order and it can be used with either the [[https://github.com/raxod502/selectrum][Selectrum]] -or [[https://github.com/abo-abo/swiper][Ivy]] completion UIs (it does not offer a completion-style that -could be used with Emacs' default completion UI or with Icomplete). -The components can be matched literally, as regexps, as initialisms or -in the flex style (called "fuzzy" in prescient). In addition to -matching, =prescient.el= also supports sorting of candidates (=orderless= -leaves that up to the candidate source and the completion UI). +components in any order and it can be used with either the [[https://github.com/raxod502/selectrum][Selectrum]] or +[[https://github.com/abo-abo/swiper][Ivy]] completion UIs (it does not offer a completion-style that could be +used with Emacs' default completion UI, Vertico or with Icomplete). The +components can be matched literally, as regexps, as initialisms or in +the flex style (called "fuzzy" in prescient). In addition to matching, +=prescient.el= also supports sorting of candidates (=orderless= leaves that +up to the candidate source and the completion UI). ** Restricting to current matches in Icicles, Ido and Ivy diff --git a/orderless.texi b/orderless.texi index 92d6d57..d465453 100644 --- a/orderless.texi +++ b/orderless.texi @@ -111,7 +111,7 @@ If you use ELPA or MELPA, the easiest way to install @samp{orderless} is via @lisp (use-package orderless :ensure t - :custom (completion-styles '(orderless))) + :custom (completion-styles '(orderless basic))) @end lisp Alternatively, put @samp{orderless.el} somewhere on your @samp{load-path}, and use @@ -119,9 +119,14 @@ the following configuration: @lisp (require 'orderless) -(setq completion-styles '(orderless)) +(setq completion-styles '(orderless basic)) @end lisp +The @samp{basic} completion style is specified as fallback in addition to +@samp{orderless} in order to ensure that completion commands which rely on +dynamic completion tables, e.g., @code{completion-table-dynamic} or +@code{completion-table-in-turn}, work correctly. + Bug reports are highly welcome and appreciated! @node Customization @@ -484,7 +489,7 @@ install Helm and configure Icomplete to use it as follows: @lisp (require 'helm) -(setq completion-styles '(helm)) +(setq completion-styles '(helm basic)) (icomplete-mode) @end lisp @@ -495,13 +500,13 @@ install Helm and configure Icomplete to use it as follows: @section Prescient The @uref{https://github.com/raxod502/prescient.el, prescient.el} library also provides matching of space-separated -components in any order and it can be used with either the @uref{https://github.com/raxod502/selectrum, Selectrum} -or @uref{https://github.com/abo-abo/swiper, Ivy} completion UIs (it does not offer a completion-style that -could be used with Emacs' default completion UI or with Icomplete). -The components can be matched literally, as regexps, as initialisms or -in the flex style (called ``fuzzy'' in prescient). In addition to -matching, @samp{prescient.el} also supports sorting of candidates (@samp{orderless} -leaves that up to the candidate source and the completion UI). +components in any order and it can be used with either the @uref{https://github.com/raxod502/selectrum, Selectrum} or +@uref{https://github.com/abo-abo/swiper, Ivy} completion UIs (it does not offer a completion-style that could be +used with Emacs' default completion UI, Vertico or with Icomplete). The +components can be matched literally, as regexps, as initialisms or in +the flex style (called "fuzzy" in prescient). In addition to matching, +@samp{prescient.el} also supports sorting of candidates (@samp{orderless} leaves that +up to the candidate source and the completion UI). @node Restricting to current matches in Icicles Ido and Ivy @section Restricting to current matches in Icicles, Ido and Ivy -- cgit v1.0