branch: externals/orderless
commit d576dc9faca16fce76b29ee302aa5969039b5d01
Author: Omar Antolín <[email protected]>
Commit: Omar Antolín <[email protected]>
Add reminder that match faces only are used if orderless "wins"
Thanks to Prot for suggesting this note.
---
README.org | 9 +++++++--
1 file changed, 7 insertions(+), 2 deletions(-)
diff --git a/README.org b/README.org
index ed6ab171b9..94ecb8d3d9 100644
--- a/README.org
+++ b/README.org
@@ -20,7 +20,6 @@ on your =load-path=, and use the following configuration:
Bug reports are highly welcome and appreciated!
* Customization
-
** Component separator regexp
The regexp components by default are space-separated, but this is
@@ -37,10 +36,16 @@ different separator for the components, bind
** Faces for component matches
The portions of a candidate matching each component get highlighted in
-one of four faces, =orderless-math-face-?= where =?= is a number from 0
+one of four faces, =orderless-match-face-?= where =?= is a number from 0
to 3. If the pattern has more than four components, the faces get
reused cyclically.
+If your =completion-styles= has more than one entry (as is usual, I
+believe), remember than Emacs tries each completion style in turn and
+uses the first one returning matches. You will only see these
+particular faces when the =orderless= completion is the one that ends up
+being used, of course.
+
* Related packages
The well-known and hugely powerful completion frameworks
[[https://github.com/abo-abo/swiper][Ivy]] and
[[https://github.com/emacs-helm/helm][Helm]]
