67 lines
2.6 KiB
Markdown
67 lines
2.6 KiB
Markdown
# register-quicknav - Quickly jump to next/previous register
|
|
|
|
*Author:* tastytea <tastytea@tastytea.de><br>
|
|
*Version:* 0.4.3<br>
|
|
*URL:* [https://schlomp.space/tastytea/register-quicknav](https://schlomp.space/tastytea/register-quicknav)<br>
|
|
|
|
This package is built on top of `register.el` and allows you to quickly jump
|
|
to the next/previous position register. If you reach the end, the search
|
|
wraps around and continues with the first (or last) register. It can be used
|
|
across all files or individually for each buffer.
|
|
|
|
## Features
|
|
|
|
* Cycle through all position registers in both directions.
|
|
* Clear current register.
|
|
* Store point in unused register (range configurable).
|
|
* Clear all registers in the unused registers range.
|
|
|
|
## Installation
|
|
|
|
To use `register-quicknav.el`, get it from
|
|
[MELPA](https://melpa.org/#/register-quicknav) or put it in your load-path
|
|
and add the following to your init.el:
|
|
|
|
(require 'register-quicknav)
|
|
(global-set-key (kbd "<C-f5>") #'register-quicknav-prev-register)
|
|
(global-set-key (kbd "<C-f6>") #'register-quicknav-next-register)
|
|
(global-set-key (kbd "<C-f7>") #'register-quicknav-point-to-unused-register)
|
|
(global-set-key (kbd "<C-S-<f7>") #'register-quicknav-clear-current-register)
|
|
|
|
Or, with use-package:
|
|
|
|
(use-package register-quicknav
|
|
:bind (("C-<f5>" . register-quicknav-prev-register)
|
|
("C-<f6>" . register-quicknav-next-register)
|
|
("C-<f7>" . register-quicknav-point-to-unused-register)
|
|
("C-S-<f7>" . register-quicknav-clear-current-register)))
|
|
|
|
## Variables
|
|
|
|
* `register-quicknav-buffer-only`: Cycle only through position registers in
|
|
current buffer. Can be safely set as file- and/or dir-local variable.
|
|
* `register-quicknav-unused-registers-begin`: Beginning of the range that is
|
|
used to search for unused registers. Defaults to `?A`.
|
|
* `register-quicknav-unused-registers-end`: End of the range that is used to
|
|
search for unused registers. Defaults to `?Z`.
|
|
|
|
## Differences to similar packages
|
|
|
|
[iregister](https://github.com/atykhonov/iregister.el):
|
|
|
|
* Opens a minibuffer on each jump (thereby requiring an extra keystroke).
|
|
* Doesn't work with file-query registers
|
|
* Can't be restricted to the current buffer.
|
|
* Doesn't look like it's still maintained.
|
|
|
|
[register-channel](https://github.com/YangZhao11/register-channel):
|
|
|
|
* Is limited to 5 position registers by default, needs an extra keybinding
|
|
for each additional register.
|
|
* Can't be restricted to the current buffer.
|
|
* Has no ability to jump to the next/previous register.
|
|
|
|
|
|
---
|
|
Converted from `register-quicknav.el` by [*el2markdown*](https://github.com/Lindydancer/el2markdown).
|