Skip to content

Commit

Permalink
Add commands to navigate by groups. Add cycling to commands.
Browse files Browse the repository at this point in the history
- Add option `selectrum-cycle-movement`.  When enabled, navigation
  commands wrap around.  Requested in #570.
- Add commands to navigate by groups (with optional cycling):
  `selectrum-next-group` and `selectrum-previous-group`.
  Requested in #554.
- Edit README.md:
  - List the new group commands.
  - Remove statement that Vertico supports cycling and group commands
    while Selectrum does not.  This is no longer true.
- Update CHANGELOG.md.
  • Loading branch information
okamsn committed Mar 3, 2022
1 parent 26908ea commit dc6fac4
Show file tree
Hide file tree
Showing 3 changed files with 339 additions and 28 deletions.
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,10 @@ The format is based on [Keep a Changelog].
([#500]).
* The face that is used when the mouse hovers over candidates can now
be customized through `selectrum-mouse-highlight` ([#507]).
* Add commands `selectrum-next-group` and `selectrum-previous-group`
([#554] , [#588]).
* Add cycling to navigation commands ([#570], [#588]) with user option
`selectrum-cycle-movement`.

### Enhancements
* When using `selectrum-insert-current-candidate` in a
Expand Down Expand Up @@ -169,7 +173,9 @@ The format is based on [Keep a Changelog].
[#528]: https://github.com/raxod502/selectrum/issues/528
[#530]: https://github.com/raxod502/selectrum/pull/530
[#537]: https://github.com/raxod502/selectrum/pull/537
[#554]: https://github.com/raxod502/selectrum/issues/554
[#569]: https://github.com/raxod502/selectrum/pull/569
[#570]: https://github.com/raxod502/selectrum/issues/570
[#571]: https://github.com/raxod502/selectrum/issues/571
[#576]: https://github.com/raxod502/selectrum/issues/576
[#577]: https://github.com/raxod502/selectrum/issues/577
Expand All @@ -179,6 +185,7 @@ The format is based on [Keep a Changelog].
[#585]: https://github.com/raxod502/selectrum/issues/585
[#586]: https://github.com/raxod502/selectrum/pull/586
[#587]: https://github.com/raxod502/selectrum/pull/587
[#588]: https://github.com/raxod502/selectrum/pull/588

## 3.1 (released 2021-02-21)
### Deprecated
Expand Down
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -214,6 +214,10 @@ how to fix it.
* *To navigate to a candidate:* use the standard motion commands
(`<up>`, `<down>`, `C-v`, `M-v`, `M-<`, `M->`). If you prefer, you
can use `C-p` and `C-n` instead of the arrow keys.
* *To navigate to a group of candidates*: use `M-{` (remapped from
`backward-paragraph`) and `M-}` (remapped from `forward-paragraph`)
to move to the previous and next group, respectively. You can also
use `C-M-p` and `C-M-n`.
* *To accept the currently selected candidate:* type `RET`/`C-m`.
(With a prefix argument, accept instead the candidate at that point
in the list, counting from one. See `selectrum-show-indices`. The
Expand Down Expand Up @@ -791,9 +795,7 @@ packages](#complementary-extensions). Many of the complementary
packages, notably Consult, work well with both Selectrum and Vertico.
Selectrum offers a flexible UI, e.g., it supports both a horizontal
and a vertical display. Furthermore it provides Avy-style quick keys
and display actions, to show the completions in a buffer. On the other
hand, Vertico additionally supports cycling over candidates and
provides more commands for grouping support.
and display actions, to show the completions in a buffer.

### Icicles

Expand Down
Loading

0 comments on commit dc6fac4

Please sign in to comment.