[elpa] externals/vertico 736f3c2 2/2: README: Improve documentation

[ELPA Syncer]

branch: externals/vertico
commit 736f3c2bd372275b9bcacdbc24ddc2a865de85b5
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>

    README: Improve documentation
---
 README.org | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/README.org b/README.org
index e1331e9..9ed7b8d 100644
--- a/README.org
+++ b/README.org
@@ -381,10 +381,9 @@ packages a try and judge for yourself.
    prioritize ~basic~ before ~orderless:~
 
    #+begin_src emacs-lisp
-     ;; Alternative 1: Configure globally
-     (setq completion-styles '(basic orderless))
-
-     ;; Alternative 2: Locally only for the problematic command
+     ;; Alternative 1: Use the basic completion style
+     (setq org-refile-use-outline-path 'file
+           org-outline-path-complete-in-steps t)
      (advice-add #'org-olpath-completing-read :around
                  (lambda (&rest args)
                    (minibuffer-with-setup-hook
@@ -392,12 +391,14 @@ packages a try and judge for yourself.
                      (apply args))))
    #+end_src
 
-   However I recommend to disable the outline path completion in steps. The
-   completion on the full path is faster since the input string matches 
directly
-   against the full path, which is particularily useful with Orderless.
+   Alternatively you may want to disable the outline path completion in steps.
+   The completion on the full path can be quicker since the input string 
matches
+   directly against substrings of the full path, which is particularily useful
+   with Orderless. However the list of possible completions becomes much more
+   cluttered.
 
    #+begin_src emacs-lisp
-     ;; Alternative 3 (Recommended)
+     ;; Alternative 2: Complete full paths
      (setq org-refile-use-outline-path 'file
            org-outline-path-complete-in-steps nil)
    #+end_src