Skip to content

avy 0.2.0

Compare
Choose a tag to compare
@abo-abo abo-abo released this 09 May 12:20
· 278 commits to master since this release

Fixes

  • avoid processing image-mode and doc-view-mode buffers
  • the jump characters are regexp-quote-ed
  • pressing RET during char selection will select end of line positions
  • avy-background works better if you're selecting among multiple windows

New Features

avy-goto-subword-0 and avy-goto-subword-1

These commands rely on subword for more precise location of subwords.

avy-setup-default

This is a function call that you can put in your config:

(avy-setup-default)

For now it only binds C-' to avy-isearch in isearch-mode-map. It's autoloaded, so you can even omit (require 'avy) in your config.

avy-goto-char-timer

This is an amalgamation of avy-goto-char (which uses one narrowing char) and avy-goto-char-2 (which uses two narrowing chars).
If you input two chars quickly (<0.5s by default), the latter is called. Otherwise, the former is called.

Customize the keys per-command

You can customize avy-keys as the all-purpose keys:

(setq avy-keys '(?a ?s ?d ?f ?g ?h ?j ?k ?l))

In addition, you can customize these keys per-command:

(setq avy-keys-alist
      `((avy-goto-word-0 .
                         ,(append (number-sequence ?A ?Z)
                                  (number-sequence ?a ?z)))
        (avy-goto-word-1 . (?f ?g ?j ?k))))

In this case, avy-goto-word-0 gets 72 decision keys, while avy-goto-word-1 gets only 4, and all others get avy-keys.

Customize the style per-command

You can customize avy-style as the all-purpose style (the default is 'pre):

(setq avy-style 'at-full)

In addition, you can customize the style per-command:

(setq avy-styles-alist
      `((avy-goto-char-2 . post)))

I think that 'post the a style best suited specifically for avy-goto-char-2 since you already type two chars in a sequence, so a third one right after is appropriate. Same for avy-isearch, that one is always 'post.

Obsoletes

Anything that's prefixed with avi- is now obsolete. I'll keep the obsolete declarations for around a month, but you should switch before warnings turn into errors. avy-goto-char-style and avy-goto-word-style are obsolete as well.