Use (orderless basic) as completion-styles (Fix #111)

1 files changed, 15 insertions, 10 deletions

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