_____________ AVY-ZAP Junpeng Qiu _____________ Table of Contents _________________ 1 Setup 2 Usage 3 Customization 4 Compared to ace-jump-zap 5 Related packages [[file:http://melpa.org/packages/avy-zap-badge.svg]] [[file:http://stable.melpa.org/packages/avy-zap-badge.svg]] Zap to char using [avy]. Note: The behaviors of the *dwim* function when called with prefix and without prefix are inverted now! By default(i.e. when the *dwim* function is called without prefix), the avy version will be used now! For those who want the old behavior, set the following variable to `nil': ,---- | (setq avy-zap-dwim-prefer-avy nil) `---- This package is basically a fork of the functionality of [ace-jump-zap], but using [avy] instead of [ace-jump-mode] as the jumping method. [[file:http://melpa.org/packages/avy-zap-badge.svg]] http://melpa.org/#/avy-zap [[file:http://stable.melpa.org/packages/avy-zap-badge.svg]] http://stable.melpa.org/#/avy-zap [avy] https://github.com/abo-abo/avy [ace-jump-zap] https://github.com/waymondo/ace-jump-zap [ace-jump-mode] https://github.com/winterTTr/ace-jump-mode 1 Setup ======= ,---- | (add-to-list 'load-path "/path/to/avy-zap.el") | (require 'avy-zap) `---- Recommendation: install `avy-zap' via [melpa]. [melpa] http://melpa.org 2 Usage ======= Use `avy-zap-to-char' or `avy-zap-up-to-char' to perform `zap-to-char' or `zap-up-to-char' in "avy-style"! There are two *Do-What-I-Mean* versions: `avy-zap-to-char-dwim' and `avy-zap-up-to-char-dwim'. `avy-zap-(up-)to-char-dwim' will perform `zap-(up-)to-char' with prefix. If calling *dwim* versions without prefix, then `avy-zap-(up-)to-char' will be used instead. The plain `zap-(up-)to-char' will also be used when you are defining or executing a macro. You can give key bindings to these commands. For example: ,---- | (global-set-key (kbd "M-z") 'avy-zap-to-char-dwim) | (global-set-key (kbd "M-Z") 'avy-zap-up-to-char-dwim) `---- 3 Customization =============== - `avy-zap-forward-only': Setting this variable to non-nil means zapping from the current point. The default value is `nil'. - `avy-zap-function': Choose between `kill-region' and `delete-region'. The default value is `kill-region'. - `avy-zap-dwim-prefer-avy': Whether the default dwim behavior(when called without prefix) of `avy-zap' should use `avy' or not. The default value is `t'. You can set this variable to `nil' if you prefer using plain zap when calling the dwim commands without prefix. 4 Compared to ace-jump-zap ========================== This package provides the same functionality as `ace-jump-zap', but lacks the `ajz/sort-by-closest' and `ajz/52-character-limit' customization options. I don't use the sorting feature of `ace-jump-zap', but if someone finds it useful, welcome to submit a pull request! 5 Related packages ================== - [ace-jump-zap] - [avy] [ace-jump-zap] https://github.com/waymondo/ace-jump-zap [avy] https://github.com/abo-abo/avy