code.delx.au - gnu-emacs-elpa/blob - packages/swiper/README.md

   1 [![Build Status](https://travis-ci.org/abo-abo/swiper.svg?branch=master)](https://travis-ci.org/abo-abo/swiper)
   2
   3 ## Swiper
   4
   5 Package for GNU Emacs that gives you an overview as you search for a regex
   6
   7 ![swiper.png](http://oremacs.com/download/swiper.png)
   8
   9 The package uses the `ivy` back end for the overview, see also
  10 [swiper-helm](https://github.com/abo-abo/swiper-helm).
  11
  12 ## Screenshots
  13
  14 ![ivy-swiper-1.png](http://oremacs.com/download/ivy-swiper-1.png)
  15
  16 There's also a ten minute [video demo](https://www.youtube.com/watch?v=VvnJQpTFVDc).
  17
  18 ## Ivy
  19
  20 Ivy is a generic completion method for Emacs, similar to
  21 `icomplete-mode`. It aims to be more efficient, more simple, and more
  22 pleasant to use than the alternatives. It's also highly customizable
  23 and very small.
  24
  25 To try it, just call <kbd>M-x</kbd> `ivy-mode`, and all generic
  26 completion, including file and buffer names, will be done with Ivy.
  27
  28 ## Installation
  29
  30 You can install the package from MELPA / GNU ELPA.
  31 Here is some typical configuration:
  32
  33 ```elisp
  34 (ivy-mode 1)
  35 (setq ivy-use-virtual-buffers t)
  36 (global-set-key "\C-s" 'swiper)
  37 (global-set-key (kbd "C-c C-r") 'ivy-resume)
  38 (global-set-key (kbd "<f6>") 'ivy-resume)
  39 (global-set-key (kbd "M-x") 'counsel-M-x)
  40 (global-set-key (kbd "C-x C-f") 'counsel-find-file)
  41 (global-set-key (kbd "<f1> f") 'counsel-describe-function)
  42 (global-set-key (kbd "<f1> v") 'counsel-describe-variable)
  43 (global-set-key (kbd "<f1> l") 'counsel-load-library)
  44 (global-set-key (kbd "<f2> i") 'counsel-info-lookup-symbol)
  45 (global-set-key (kbd "<f2> u") 'counsel-unicode-char)
  46 (global-set-key (kbd "C-c g") 'counsel-git)
  47 (global-set-key (kbd "C-c j") 'counsel-git-grep)
  48 (global-set-key (kbd "C-c k") 'counsel-ag)
  49 (global-set-key (kbd "C-x l") 'counsel-locate)
  50 (global-set-key (kbd "C-S-o") 'counsel-rhythmbox)
  51 ```