1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
From: Aymeric Agon-Rambosson <aymeric.agon@yandex.com>
Date: Thu, 18 Aug 2022 19:44:56 +0200
Subject: Drop references to external pages and debianise
Forwarded: not-needed
--- a/README.org
+++ b/README.org
@@ -24,15 +24,16 @@ tab completion), with the built-in Icomp
to the more well-known Ido Mode), the icomplete-vertical variant from
Emacs 28 (see the external [[https://github.com/oantolin/icomplete-vertical][icomplete-vertical]] package to get that
functionality on earlier versions of Emacs), or with some third party
-minibuffer completion frameworks such as [[https://gitlab.com/protesilaos/mct][Mct]] or [[https://github.com/minad/vertico][Vertico]].
+minibuffer completion frameworks such as
+[[https://gitlab.com/protesilaos/mct][Mct]] or Vertico (~apt install elpa-vertico~).
All the completion UIs just mentioned are for minibuffer completion,
used when Emacs commands prompt the user in the minibuffer for some
input, but there is also completion at point in normal buffers,
typically used for identifiers in programming languages. Completion
styles can also be used for that purpose by completion at point UIs
-such as [[https://github.com/minad/corfu][Corfu]], [[https://company-mode.github.io/][Company]] or the function =consult-completion-in-region=
-from [[https://github.com/minad/consult][Consult]].
+such as [[https://github.com/minad/corfu][Corfu]], Company (~apt install elpa-company~) or the function =consult-completion-in-region=
+from Consult (~apt install elpa-consult~).
To use a completion style with any of the above mentioned completion
UIs simply add it as an entry in the variables =completion-styles= and
@@ -46,13 +47,13 @@ exclusively, set both variables to =nil=
With a bit of effort, it might still be possible to use =orderless= with
other completion UIs, even if those UIs don't support the standard
-Emacs completion styles. Currently there is support for [[https://github.com/abo-abo/swiper][Ivy]] (see
+Emacs completion styles. Currently there is support for Ivy (~apt install elpa-ivy~) (see
below). Also, while Company does support completion styles directly,
pressing =SPC= takes you out of completion, so comfortably using
=orderless= with it takes a bit of configuration (see below).
If you use ELPA or MELPA, the easiest way to install =orderless= is via
-=package-install=. If you use =use-package=, you can use:
+=package-install=. If you use =use-package= (~apt install elpa-use-package~), you can use:
#+begin_src emacs-lisp
(use-package orderless
@@ -304,11 +305,11 @@ the above configuration, you'd need to u
indicates that the completion candidates are commands or symbols. In
Emacs 28, =execute-extended-command= has metadata indicating you are
selecting a command, but earlier versions of Emacs lack this metadata.
-Activating =marginalia-mode= from the [[https://github.com/minad/marginalia][Marginalia]] package provides this
-metadata automatically for many built-in commands and is recommended
-if you use the above example configuration, or other similarly
-fine-grained control of completion styles according to completion
-category.
+Activating =marginalia-mode= from the Marginalia (~apt install
+elpa-marginalia~) package provides this metadata automatically for many
+built-in commands and is recommended if you use the above example
+configuration, or other similarly fine-grained control of completion
+styles according to completion category.
** Faces for component matches
@@ -338,10 +339,10 @@ configuration on the fly while matching.
interfaces for this: you could toggle between two chosen
configurations, cycle among several, have a keymap where each key sets
a different configurations, have a set of named configurations and be
-prompted (with completion) for one of them, popup a [[https://github.com/abo-abo/hydra][hydra]] to choose a
-configuration, etc. Since there are so many possible UIs and which to
-use is mostly a matter of taste, =orderless= does not provide any such
-commands. But it's easy to write your own!
+prompted (with completion) for one of them, popup a hydra (~apt install
+elpa-hydra~) to choose a configuration, etc. Since there are so many
+possible UIs and which to use is mostly a matter of taste, =orderless=
+does not provide any such commands. But it's easy to write your own!
For example, say you want to use the keybinding =C-l= to make all
components match literally. You could use the following code:
@@ -446,7 +447,8 @@ can add this to your configuration:
** Ivy and Helm
-The well-known and hugely powerful completion frameworks [[https://github.com/abo-abo/swiper][Ivy]] and [[https://github.com/emacs-helm/helm][Helm]]
+The well-known and hugely powerful completion frameworks Ivy (~apt
+install elpa-ivy~) and Helm (~apt install elpa-helm~)
also provide for matching space-separated component regexps in any
order. In Ivy, this is done with the =ivy--regex-ignore-order= matcher.
In Helm, it is the default, called "multi pattern matching".
|
