[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/orderless 4844452f4e 139/204: Update documentation
From: |
ELPA Syncer |
Subject: |
[elpa] externals/orderless 4844452f4e 139/204: Update documentation |
Date: |
Tue, 11 Jan 2022 12:58:24 -0500 (EST) |
branch: externals/orderless
commit 4844452f4e7008da2ebe96c7dbbb7bcd655bbe68
Author: Omar Antolín <omar.antolin@gmail.com>
Commit: Omar Antolín <omar.antolin@gmail.com>
Update documentation
1. Mention setting completion-category-defaults to nil.
2. Update comments about Selectrum.
---
README.org | 40 ++++++++++++++++++++++++----------------
orderless.texi | 57 +++------------------------------------------------------
2 files changed, 27 insertions(+), 70 deletions(-)
diff --git a/README.org b/README.org
index 847b041b77..a8102fe49f 100644
--- a/README.org
+++ b/README.org
@@ -10,7 +10,7 @@
[[https://stable.melpa.org/#/orderless][file:https://stable.melpa.org/packages/orderless-badge.svg]]
:END:
-* Overview
+* COMMENT Overview
:PROPERTIES:
:TOC: :include all :ignore this
:END:
@@ -28,38 +28,45 @@ used with the default Emacs completion UI (sometimes called
minibuffer
tab completion) or with the built-in Icomplete package (which is
similar to the more well-known Ido Mode). To use a completion style in
this fashion simply add it as an entry in the variables
-=completion-styles= and =completion-category-overrides= (see their
-documentation).
+=completion-styles= or =completion-category-overrides= (see their
+documentation). Note that there is also the variable
+=completion-category-defaults= which configures some completion styles
+for special kinds of completion by default. If you want to use /only/
+orderless, set that variable 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]] and
-[[https://github.com/raxod502/selectrum][Selectrum]] (see below).
-
-If you use MELPA, the easiest way to install =orderless= is via
-=package-install=. If you use both MELPA and =use-package=, you can use:
+Emacs completion styles. Currently there is support for
[[https://github.com/raxod502/selectrum][Selectrum]] and
+[[https://github.com/abo-abo/swiper][Ivy]] (see below).
#+begin_src emacs-lisp
(use-package orderless
:ensure t
- :init (icomplete-mode) ; optional but recommended!
- :custom (completion-styles '(orderless)))
+ :init (icomplete-mode) ; optional but recommended
+ :custom
+ (completion-styles '(orderless))
+ (completion-category-defaults nil)) ; optional
#+end_src
Alternatively, put =orderless.el= somewhere on your =load-path=, and use
the following configuration:
+If you use MELPA, the easiest way to install =orderless= is via
+=package-install=. If you use both MELPA and =use-package=, you can use:
+
#+begin_src emacs-lisp
-(require 'orderless)
-(setq completion-styles '(orderless))
-(icomplete-mode) ; optional but recommended!
+ (require 'orderless)
+ (setq completion-styles '(orderless)
+ completion-category-defaults nil) ; optional
+ (icomplete-mode) ; optional but recommended
#+end_src
(And of course, if you use another completion framework such as Ivy or
Helm, disable it.)
If you like the experience of using =orderless= with Icomplete, but wish
-the candidates displayed vertically, you can use
[[https://github.com/oantolin/icomplete-vertical][icomplete-vertical]].
+the candidates displayed vertically, you can use
[[https://github.com/oantolin/icomplete-vertical][icomplete-vertical]],
+[[https://github.com/raxod502/selectrum][Selectrum]] or
[[https://github.com/abo-abo/swiper][Ivy]].
Bug reports are highly welcome and appreciated!
@@ -353,8 +360,9 @@ To use =orderless= from Ivy add this to your Ivy
configuration:
** Selectrum
-To use =orderless= from Selectrum add this to your Selectrum
-configuration:
+Recent versions of Selectrum use your configured completion styles by
+default! To use =orderless= from Selectrum, you can either stick to that
+default or add this to your Selectrum configuration:
#+begin_src emacs-lisp
(setq selectrum-refine-candidates-function #'orderless-filter)
diff --git a/orderless.texi b/orderless.texi
index 0aa29c6b02..c1dc217516 100644
--- a/orderless.texi
+++ b/orderless.texi
@@ -25,7 +25,6 @@
@end ifnottex
@menu
-* Overview::
* Customization::
* Integration with other completion UIs::
* Related packages::
@@ -60,57 +59,6 @@ Related packages
@end detailmenu
@end menu
-@node Overview
-@chapter Overview
-
-This package provides an @samp{orderless} @emph{completion style} that divides
the
-pattern into space-separated components, and matches candidates that
-match all of the components in any order. Each component can match in
-any one of several ways: literally, as a regexp, as an initialism, in
-the flex style, or as multiple word prefixes. By default, regexp and
-initialism matches are enabled.
-
-A completion style is a back-end for completion and is used from a
-front-end that provides a completion UI@. Any completion style can be
-used with the default Emacs completion UI (sometimes called minibuffer
-tab completion) or with the built-in Icomplete package (which is
-similar to the more well-known Ido Mode). To use a completion style in
-this fashion simply add it as an entry in the variables
-@samp{completion-styles} and @samp{completion-category-overrides} (see their
-documentation).
-
-With a bit of effort, it might still be possible to use @samp{orderless} with
-other completion UIs, even if those UIs don't support the standard
-Emacs completion styles. Currently there is support for
@uref{https://github.com/abo-abo/swiper, Ivy} and
-@uref{https://github.com/raxod502/selectrum, Selectrum} (see below).
-
-If you use MELPA, the easiest way to install @samp{orderless} is via
-@samp{package-install}. If you use both MELPA and @samp{use-package}, you can
use:
-
-@lisp
-(use-package orderless
- :ensure t
- :init (icomplete-mode) ; optional but recommended!
- :custom (completion-styles '(orderless)))
-@end lisp
-
-Alternatively, put @samp{orderless.el} somewhere on your @samp{load-path}, and
use
-the following configuration:
-
-@lisp
-(require 'orderless)
-(setq completion-styles '(orderless))
-(icomplete-mode) ; optional but recommended!
-@end lisp
-
-(And of course, if you use another completion framework such as Ivy or
-Helm, disable it.)
-
-If you like the experience of using @samp{orderless} with Icomplete, but wish
-the candidates displayed vertically, you can use
@uref{https://github.com/oantolin/icomplete-vertical, icomplete-vertical}.
-
-Bug reports are highly welcome and appreciated!
-
@node Customization
@chapter Customization
@@ -421,8 +369,9 @@ To use @samp{orderless} from Ivy add this to your Ivy
configuration:
@node Selectrum
@section Selectrum
-To use @samp{orderless} from Selectrum add this to your Selectrum
-configuration:
+Recent versions of Selectrum use your configured completion styles by
+default! To use @samp{orderless} from Selectrum, you can either stick to that
+default or add this to your Selectrum configuration:
@lisp
(setq selectrum-refine-candidates-function #'orderless-filter)
- [elpa] externals/orderless b63019aea3 090/204: Add missing (oops!) "forgiving funcall" function, (continued)
- [elpa] externals/orderless b63019aea3 090/204: Add missing (oops!) "forgiving funcall" function, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless 74947d0862 092/204: Update dispatchers documentation, and documents pattern compiler, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless c245cb6e9d 091/204: Make dispatchers always take 3 args (to avoid depending on 26.1), ELPA Syncer, 2022/01/11
- [elpa] externals/orderless c1be870f02 101/204: Undocument orderless-temporarily-change-separator in README, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless d0b217512f 104/204: Switch to single variable config, add transient vars, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless 5618c349a6 107/204: Remove global dispatchers, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless e56eeef6e1 126/204: Merge pull request #22 from jcs-PR/badge, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless f49a0faceb 128/204: Off by one error in orderless-without-literal, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless ef9bff0020 133/204: Modify readme for better texinfo export, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless ec71107992 138/204: Merge branch 'master' of https://github.com/oantolin/orderless, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless 4844452f4e 139/204: Update documentation,
ELPA Syncer <=
- [elpa] externals/orderless 9f18a34d7e 141/204: Revert documentation for #31, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless ea60844b82 151/204: Add missing funcall in decision whether to skip highlighting, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless b8e7e53a8f 152/204: Don't recommend icomplete (fix #36), ELPA Syncer, 2022/01/11
- [elpa] externals/orderless edce950fe1 155/204: Capture empty string to avoid highlighting for strict initialism, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless e5cb3f7b57 164/204: update readme, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless 05fc3d223e 169/204: fix typo, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless 8d187bd31e 171/204: Only enable regexp and literal matching styles by default, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless d13f47df73 173/204: Bump version number, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless 0205fb5b0e 170/204: Merge pull request #50 from minad/typo, ELPA Syncer, 2022/01/11
- [elpa] externals/orderless 94e8940ac1 175/204: Omit null components (fix #55), ELPA Syncer, 2022/01/11