[elpa] externals/orderless 3fca979f6e 1/7: Use (orderless basic) as completion-styles (Fix #111)

[ELPA Syncer]

branch: externals/orderless
commit 3fca979f6ee9d9973290e08eb38bfa4727284bc7
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>

    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 a508befa1c..4d19f7fa1a 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 92d6d5771d..d465453bef 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