[elpa] externals/vertico fd8fa8ef53: Update vertico-flat documentation (#169)

[ELPA Syncer]

branch: externals/vertico
commit fd8fa8ef537b169650466b85ae03a425ee82d52e
Author: gcv <vetoshev@gmail.com>
Commit: GitHub <noreply@github.com>

    Update vertico-flat documentation (#169)
    
    * Mention vertico-cycle in vertico-flat commentary.
    
    * Add hint about vertico-cycle and vertico-flat.
    
    * Fix typo.
---
 README.org                 | 13 +++++++++++++
 extensions/vertico-flat.el |  3 +++
 2 files changed, 16 insertions(+)

diff --git a/README.org b/README.org
index 97643df5dd..9451127e05 100644
--- a/README.org
+++ b/README.org
@@ -327,6 +327,19 @@ Furthermore you can tune buffer-local settings per command 
(or category).
            (seq-remove (lambda (x) (string-suffix-p "/" x)) files)))
 #+end_src
 
+As another example, the following code uses ~vertico-flat~ and ~vertico-cycle~ 
to
+emulate ~(ido-mode 'buffer)~, i.e. Ido when it is enabled only for completion 
of
+buffer names. ~vertico-cycle~ set to ~t~ is necessary here to prevent 
completion
+candidates from disappearing when they scroll off-screen to the left.
+
+#+begin_src emacs-lisp
+  (setq vertico-multiform-category-modes
+        '((buffer flat)))
+
+  (setq vertico-multiform-category-settings
+        '((buffer (vertico-cycle . t))))
+#+end_src
+
 Combining these features allows us to fine-tune the completion display even 
more
 by adjusting the ~vertico-buffer-display-action~. We can for example reuse the
 current window for commands of the ~consult-grep~ category (~consult-grep~,
diff --git a/extensions/vertico-flat.el b/extensions/vertico-flat.el
index cc40c9cfc7..3bf377558b 100644
--- a/extensions/vertico-flat.el
+++ b/extensions/vertico-flat.el
@@ -33,6 +33,9 @@
 ;; key to toggle to the horizontal display:
 ;;
 ;; (define-key vertico-map "\M-F" #'vertico-flat-mode)
+;;
+;; `vertico-flat-mode' can be made to look like `ido-mode' by setting
+;; `vertico-cycle' to `t'.
 
 ;;; Code: