[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/vertico 953ff1e 10/11: README: Document keymap
From: |
Protesilaos Stavrou |
Subject: |
[elpa] externals/vertico 953ff1e 10/11: README: Document keymap |
Date: |
Thu, 8 Apr 2021 07:11:17 -0400 (EDT) |
branch: externals/vertico
commit 953ff1ed6f592ac635fc317bead4c428f78f8ca6
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>
README: Document keymap
---
README.org | 26 ++++++++++++++++++++++----
1 file changed, 22 insertions(+), 4 deletions(-)
diff --git a/README.org b/README.org
index fbab1ad..f19160c 100644
--- a/README.org
+++ b/README.org
@@ -21,14 +21,32 @@ externally by complementary packages.
- Non-existing candidates are entered by moving the point to the prompt line
- Candidates are sorted by history, string length and alphabetically
- Long candidates with newlines are formatted to take up less space
-- Support for =annotation-function=, =affixation-function= and
=x-group-function=
+- Support for ~annotation-function~, ~affixation-function~ and
~x-group-function~
+
+* Keymap
+
+Vertico defines its own local keymap in the minibuffer which is derived from
+~minibuffer-local-map~. The keymap mostly keeps the ~fundamental-mode~
+keybindings intact, but rebinds a few commands. Note in particular the binding
+of =TAB= to ~vertico-insert~ and the bindings of ~vertico-exit/exit-input~.
+
+- ~beginning-of-buffer~, ~minibuffer-beginning-of-buffer~ ->
~vertico-beginning-of-buffer~
+- ~end-of-buffer~ -> ~vertico-end-of-buffer~
+- ~scroll-down-command~ -> ~vertico-scroll-down~
+- ~scroll-up-command~ -> ~vertico-scroll-up~
+- ~next-line~, ~next-line-or-history-element~ -> ~vertico-next~
+- ~previous-line~, ~previous-line-or-history-element~ -> ~vertico-previous~
+- ~exit-minibuffer~ -> ~vertico-exit~
+- ~kill-ring-save~ -> ~vertico-save~
+- =<C-return>= -> ~vertico-exit-input~
+- =TAB= -> ~vertico-insert~
* Configuration
Vertico is available from [[http://elpa.gnu.org/packages/vertico.html][GNU
ELPA]], such that it can be installed directly via
-=package-install=. After installation, the global minor mode can be enabled
with
+~package-install~. After installation, the global minor mode can be enabled
with
=M-x vertico-mode=. In order to configure Vertico and other packages in your
-init.el, you may want to use =use-package=. Here is an example configuration:
+init.el, you may want to use ~use-package~. Here is an example configuration:
#+begin_src emacs-lisp
;; Enable vertico
@@ -81,7 +99,7 @@ disadvantages. The
[[https://github.com/raxod502/selectrum][Selectrum readme]] p
available completion systems from the perspective of Selectrum.
Vertico aims to be fully compliant with all Emacs commands and achieves that
-with a minimal code base, relying purely on =completing-read= while avoiding to
+with a minimal code base, relying purely on ~completing-read~ while avoiding to
invent its own APIs. Inventing a custom API as Helm or Ivy is explicitly
avoided
in order to increase flexibility and package reuse.
- [elpa] externals/vertico updated (1a9b1b2 -> 82ed224), Protesilaos Stavrou, 2021/04/08
- [elpa] externals/vertico d65eeac 04/11: vertico--recompute-candidates: Move exact input and default to front, Protesilaos Stavrou, 2021/04/08
- [elpa] externals/vertico ee77886 01/11: Expand README, Protesilaos Stavrou, 2021/04/08
- [elpa] externals/vertico c734b0f 02/11: Minor simplification and docstring updates, Protesilaos Stavrou, 2021/04/08
- [elpa] externals/vertico d9bb816 09/11: README: Mention a few more useful configurations, Protesilaos Stavrou, 2021/04/08
- [elpa] externals/vertico 403e154 05/11: Fix #2 - Screenshot background, Protesilaos Stavrou, 2021/04/08
- [elpa] externals/vertico edf6a06 08/11: Do not always overwrite resize-mini-windows (See #5), Protesilaos Stavrou, 2021/04/08
- [elpa] externals/vertico bf76000 06/11: Rename vertico--pred to vertico--sort-predicate, Protesilaos Stavrou, 2021/04/08
- [elpa] externals/vertico 1522d9a 07/11: Extract vertico--file-predicate, Protesilaos Stavrou, 2021/04/08
- [elpa] externals/vertico 953ff1e 10/11: README: Document keymap,
Protesilaos Stavrou <=
- [elpa] externals/vertico 82ed224 11/11: Package: Remove license header in order to fix the ELPA linter, Protesilaos Stavrou, 2021/04/08
- [elpa] externals/vertico a68f4cf 03/11: vertico--format-candidates: Only add space for point if eobp, Protesilaos Stavrou, 2021/04/08