code.delx.au - gnu-emacs-elpa/blob - packages/swiper/doc/Changelog.org

   1 #+OPTIONS: toc:nil
   2 * 0.6.0
   3 ** Fixes
   4 *** =swiper-avy= should use only the current window
   5 Not all windows. See [[https://github.com/abo-abo/swiper/issues/117][#117]].
   6 *** fix wrap-around for =ivy-next-line=
   7 See [[https://github.com/abo-abo/swiper/issues/118][#118]].
   8 *** =swiper-avy= should do nothing for empty input
   9 See [[https://github.com/abo-abo/avy/issues/50][#50]].
  10 *** =ivy-alt-done= should require TRAMP if necessary
  11 See [[https://github.com/abo-abo/swiper/pull/145][#145]].
  12 *** =swiper-query-replace= shouldn't miss the first occurrence
  13 See [[https://github.com/abo-abo/swiper/pull/144][#144]].
  14 *** =swiper= should not deactivate mark
  15 *** =ivy-mode= should not switch to TRAMP for certain input
  16 See [[https://github.com/abo-abo/swiper/pull/145][#145]].
  17 *** =counsel-find-file= should work better with TRAMP
  18 "/ssh:foo" should not be cut off
  19 See [[https://github.com/abo-abo/swiper/pull/145][#145]].
  20 *** =counsel-find-file= supports Windows drive letters
  21 See [[https://github.com/abo-abo/swiper/pull/155][#155]].
  22 *** =counsel-file-file= should work better with files that contain "~"
  23 See [[https://github.com/abo-abo/swiper/pull/157][#157]].
  24 *** =counsel-M-x= should respect =ivy-format-function=
  25 See [[https://github.com/abo-abo/swiper/pull/150][#150]].
  26 *** =counsel-git-grep= should position better on exit
  27 See [[https://github.com/abo-abo/swiper/pull/153][#153]].
  28 *** =ivy-mode= should re-scale text to minibuffer height
  29 See [[https://github.com/abo-abo/swiper/pull/151][#151]].
  30 *** =counsel-unicode-char= should use action-style call
  31 See [[https://github.com/abo-abo/swiper/pull/160][#160]].
  32 *** =ivy-read= should allow % in prompt string
  33 See [[https://github.com/abo-abo/swiper/pull/171][#171]].
  34 *** =ivy-call= should execute in proper window
  35 See [[https://github.com/abo-abo/swiper/pull/176][#176]].
  36 ** New Features
  37 *** =ivy-mode=
  38 **** Open an Info file on the file system
  39 When in =Info-mode=, press ~g~ and select either "(./)" or "(../)" to
  40 switch to file name completion. That file will be opened with Info.
  41 **** Account for =minibuffer-depth-indication-mode=
  42 If you have =minibuffer-depth-indication-mode= on, the minibuffer
  43 prompt will indicate the current depth.
  44 See [[https://github.com/abo-abo/swiper/pull/134][#134]].
  45 **** Add fuzzy matching function
  46 To enable fuzzy matching, set your =ivy-re-builders-alist= accordingly:
  47 #+begin_src elisp
  48 (setq ivy-re-builders-alist
  49       '((t . ivy--regex-fuzzy)))
  50 #+end_src
  51 See [[https://github.com/abo-abo/swiper/pull/136][#136]].
  52
  53 See also [[https://github.com/abo-abo/swiper/pull/142][#142]] for toggling fuzzy matching with ~C-o m~.
  54 **** =case-fold-search= optimization
  55 Bind case-fold-search to t when the input is all lower-case:
  56
  57 - input "the" matches both "the" and "The".
  58 - input "The" matches only "The".
  59
  60 See [[https://github.com/abo-abo/swiper/pull/166][#166]].
  61 **** Allow to see the candidate index a la =anzu= via =ivy-count-format=
  62 To have this feature, use something like this:
  63 #+begin_src elisp
  64 (setq ivy-count-format "(%d/%d) ")
  65 #+end_src
  66 See [[https://github.com/abo-abo/swiper/pull/167][#167]].
  67
  68 You can also set this to "", if you don't want any count, see [[https://github.com/abo-abo/swiper/pull/188][#188]].
  69 **** Allow to add additional exit points for any command
  70 Example for =ivy-switch-to-buffer=:
  71 #+begin_src elisp
  72 (ivy-set-actions
  73  'ivy-switch-buffer
  74  '(("k"
  75     (lambda (x)
  76       (kill-buffer x)
  77       (ivy--reset-state ivy-last))
  78     "kill")
  79    ("j"
  80     ivy--switch-buffer-other-window-action
  81     "other")))
  82 #+end_src
  83
  84 After this:
  85
  86 - use ~M-o k~ to kill a buffer
  87 - use ~M-o j~ to switch to a buffer in other window
  88
  89 You can always use ~M-o o~ to access the default action. When there is
  90 only one action, ~M-o~ does the same as ~C-m~.
  91
  92 See [[https://github.com/abo-abo/swiper/pull/164][#164]].
  93
  94
  95
  96
  97
  98
  99
 100
 101 *** =counsel-describe-function= and =counsel-decribe-variable=
 102 **** Add a binding to look up the symbol in info
 103 Press ~C-,~ to look up the symbol in info, instead of the default
 104 describe action.
 105 See [[https://github.com/abo-abo/swiper/pull/121][#121]].
 106 **** Handle symbol-at-point better in non-Elisp buffers
 107 See [[https://github.com/abo-abo/swiper/pull/126][#126]].
 108 *** =ivy-switch-buffer=
 109 **** New face =ivy-virtual=
 110 See [[https://github.com/abo-abo/swiper/pull/129][#129]].
 111 **** Deal better with invisible buffers
 112 See [[https://github.com/abo-abo/swiper/pull/135][#135]].
 113 **** Add custom keymap
 114 You can customize =ivy-switch-buffer-map=.
 115
 116 See [[https://github.com/abo-abo/swiper/pull/164][#164]].
 117 **** Add extra actions
 118 Add a =kill-buffer= action, and =switch-to-buffer-other-window= action.
 119 *** =counsel-git-grep=
 120 **** Add Async
 121 Make it fully async: the process =git grep= will be killed and
 122 restarted on new input. This results in almost no keyboard delay.
 123 **** Own history variable
 124 *** =swiper=
 125 **** Own history variable
 126 Having own history variable allows to get more use of ~M-p~, ~M-n~ and ~C-r~.
 127 *** =counsel-el=
 128 **** Switch to action-style call
 129 This allows to make use of ~C-M-n~ and ~C-M-p~.
 130 *** =counsel-locate=
 131 **** Add Async
 132 **** Add extra actions
 133 In addition to the default action of opening a file add:
 134
 135 - =xdg-open= action
 136 - =dired= action
 137
 138 Press ~M-o~ or ~C-o~ to access these actions.
 139 **** Add own history
 140
 141 *** API
 142 **** Add :matcher
 143 A matcher is a function that accepts a regexp and a list of candidates
 144 and returns the filtered list of candidates.
 145
 146 The default matcher is basically =cl-remove-if-not= + =string-match=.
 147 If you'd like to customize this, pass your own matcher.
 148
 149 See =counsel-git-grep-matcher= for an example.
 150 **** Allow to customize the initial input for all commands
 151 Customize =ivy-initial-inputs-alist= for this.
 152 See [[https://github.com/abo-abo/swiper/pull/140][#140]].
 153 **** =ivy-sort-functions-alist= should also examine =this-command=
 154 **** :dynamic-collection is now a boolean
 155 Pass the collection function as the second var instead.
 156
 157 ** New Commands
 158 *** =ivy-call=
 159 Execute the current action for the current candidate without exiting
 160 the minibuffer.  Bound to ~C-M-m~ or ~M-RET~ or ~C-o g~.
 161
 162
 163 *** =counsel-find-file=
 164 Forward to =find-file= with Ivy completion.
 165
 166 =ivy-next-line-and-call= as well as =ivy-resume= should work for this command.
 167
 168 The variable =counsel-find-file-ignore-regexp= allows to ignore
 169 certain files, like dot files.  Input a leading dot to see all files.
 170
 171 The variable =counsel-find-file-at-point= allows to automatically use
 172 =ffap=.  You also can do it manually with ~M-n~ when the point is on a file name.
 173
 174 The variable =counsel-find-file-map= allows to customize the
 175 minibuffer key bindings for this command.
 176
 177 Recommended binding:
 178
 179 #+begin_src elisp
 180 (global-set-key (kbd "C-x C-f") 'counsel-find-file)
 181 #+end_src
 182
 183 You can peek at files with ~C-M-n~ and ~C-M-p~.
 184
 185 See [[https://github.com/abo-abo/swiper/issues/122][#122]] and [[https://github.com/abo-abo/swiper/issues/123][#123]].
 186
 187 See [[https://github.com/abo-abo/swiper/pull/152][#152]] about ~M-n~, ~M-p~ and ~M-i~ switching directories when necessary.
 188
 189 *** =ivy-recentf=
 190 Find a file on =recentf-list=.
 191
 192 Note that if your set =ivy-use-virtual-buffers=, =recentf-list= is
 193 merged into candidates list for =ivy-switch-buffer=. But if you want
 194 it separately, you can use this command.
 195
 196 See [[https://github.com/abo-abo/swiper/issues/124][#124]].
 197 *** =ivy-yank-word=
 198 Add word at point to minibuffer input.
 199
 200 This is similar to what ~C-w~ does for =isearch=.  However it's bound
 201 to ~M-j~ instead of ~C-w~, since ~C-w~ is bound to =kill-region= - a
 202 useful command.
 203
 204 See [[https://github.com/abo-abo/swiper/issues/125][#125]].
 205 *** =counsel-M-x=
 206 Forward to =execute-extended-command= with Ivy completion.
 207 The candidate list will also display the key binding for each bound command.
 208
 209 This command will piggyback on =smex= for sorting, if =smex= is installed.
 210
 211 Use =counsel-M-x-initial-input= to customize the initial input for
 212 this command.  By default, it's "^" - the regex character that
 213 indicates beginning of string.  This results in much faster matching,
 214 since you usually type the command name from the start.
 215
 216 See [[https://github.com/abo-abo/swiper/pull/136][#136]] and [[https://github.com/abo-abo/swiper/pull/138][#138]].
 217
 218 *** =hydra-ivy=
 219 Press ~C-o~ to toggle the Hydra for Ivy.
 220 It gives access to shorter bindings and many customizable options.
 221
 222 Use ~C-o >~ to grow the minibuffer.
 223 Use ~C-o <~ to shrink the minibuffer.
 224
 225 See [[https://github.com/abo-abo/swiper/pull/151][#151]].
 226
 227 *** =ivy-toggle-calling=
 228 Toggle executing the current action each time a new candidate is selected.
 229
 230 This command is bound to ~C-o c~.
 231
 232 To explain how this is useful: ~C-M-m C-M-f C-M-f C-M-f~  is equivalent to ~C-o cjjj~.
 233
 234 *** =ivy-insert-current=
 235 Inserts the current candidate into the minibuffer.
 236
 237 Press ~M-i~ if you want something close to the current candidate. You
 238 can follow up with an edit and select.
 239
 240 I find this very useful when creating new files with a similar name to
 241 the existing file: ~C-x C-f M-i~ + a bit of editing is very fast.
 242
 243 See [[https://github.com/abo-abo/swiper/pull/141][#141]].
 244
 245 *** =counsel-load-theme=
 246 Forward to =load-theme= with Ivy completion. Allows to rapidly try themes (e.g. with ~C-M-n~).
 247
 248 *** =ivy-reverse-i-search=
 249 Allow to recursively match history with ~C-r~.
 250
 251 I like this command from bash shell. The usual way to search through
 252 history is with ~M-p~ and ~M-n~.  Using =ivy-reverse-i-search= will
 253 open a recursive completion session with the current history as the
 254 candidates.
 255 *** =counsel-rhythmbox=
 256 [[http://oremacs.com/2015/07/09/counsel-rhythmbox/][Control Rhythmbox from Emacs.]]
 257 *** =ivy-dispatching-done=
 258 Select an action for the current candidate and execute it. Bound to ~M-o~.
 259
 260 Some commands that support ~M-o~:
 261
 262 - =counsel-rhythmbox=
 263 - =counsel-describe-function=
 264 - =counsel-describe-variable=
 265 - =ivy-switch-buffer=
 266 - =counsel-locate=
 267
 268 *** =counsel-org-tag=
 269 Forward to =org-set-tags= with Ivy completion.
 270
 271 Selecting any tag each time will toggle it on/off.
 272 The current list of selected tags will be displayed in the prompt.
 273
 274 See [[https://github.com/abo-abo/swiper/pull/177][#177]] and [[https://github.com/abo-abo/swiper/pull/91][#91]].
 275
 276 *** =counsel-org-tag-agenda=
 277 Forward to =org-agenda-set-tags= with Ivy completion.
 278 See [[https://github.com/abo-abo/swiper/pull/177][#177]].
 279
 280 *** =counsel-ag=
 281 Interactively =ag= using Ivy completion.
 282
 283 *** =counsel-recoll=
 284 Use =recoll= with Ivy completion.
 285 See [[http://oremacs.com/2015/07/27/counsel-recoll/][Using Recoll desktop search database with Emacs]].
 286
 287 Install recoll with =sudo apt-get install recoll=.
 288
 289 *** =swiper-from-isearch=
 290 Start =swiper= from the current =isearch= input.
 291
 292 *** =ivy-immediate-done=
 293 Use this command to exit the minibuffer choosing not the current
 294 candidate, but the current text.  Bound to ~C-M-j~ or ~C-u C-j~.
 295
 296 See [[https://github.com/abo-abo/swiper/pull/183][#183]].
 297
 298 * 0.7.0
 299 ** Fixes
 300 *** Fix :dynamic-collection not being sorted
 301 *** When :initial-input contains a plus, escape it
 302 See [[https://github.com/abo-abo/swiper/issues/195][#195]].
 303 *** Set line-spacing to 0 in the minibuffer
 304 See [[https://github.com/abo-abo/swiper/issues/198][#198]].
 305 *** Enlarge the minibuffer window if the candidate list doesn't fit
 306 See [[https://github.com/abo-abo/swiper/issues/198][#198]] and [[https://github.com/abo-abo/swiper/issues/161][#161]] and [[https://github.com/abo-abo/swiper/issues/220][#220]].
 307 *** Fix minibuffer collapsing to one line
 308 See [[https://github.com/abo-abo/swiper/issues/237][#237]], [[https://github.com/abo-abo/swiper/issues/229][#229]] and [[https://github.com/abo-abo/swiper/issues/77][#77]].
 309 *** Use minibuffer-allow-text-properties
 310 Allows =ivy-read= to return a propertized string.
 311 *** Improve ~C-g~ out of a long-running async process
 312 Use =counsel-delete-process= as =:unwind=.
 313 *** Don't regexp-quote :preselect
 314 See [[https://github.com/abo-abo/swiper/issues/245][#245]].
 315 *** Fix ivy-partial for fuzzy completion
 316 See [[https://github.com/abo-abo/swiper/issues/266][#266]].
 317 *** ivy-resume should pass :caller
 318 See [[https://github.com/abo-abo/swiper/issues/245][#245]].
 319 *** Fix the regression in perfect match logic
 320 See [[https://github.com/abo-abo/swiper/issues/270][#270]].
 321 *** Fix pasting file paths on Windows
 322 *** ~C-j~ should no stop completion for a pasted file path
 323 *** ~C-M-j~ should use =ivy--directory=
 324 When completing file names, expand the file name properly.
 325 See [[https://github.com/abo-abo/swiper/issues/275][#275]].
 326 *** Use a specific blend method for dark themes
 327 See [[https://github.com/abo-abo/swiper/issues/278][#278]].
 328 *** Fix one-off bug in =ivy-scroll-up-command= and =ivy-scroll-down-command=
 329 *** ~M-o~ shouldn't set the action permanently
 330 So now it's possible to e.g. =counsel-describe-function= -> ~M-o d~ ->
 331 =ivy-resume= -> ~M-o o~ -> =ivy-resume= -> ~M-o i~.
 332 *** Fix swiper preselect issue with similar or identical lines
 333 See [[https://github.com/abo-abo/swiper/issues/290][#290]].
 334 *** Make ivy-completing-read handle history as cons
 335 See [[https://github.com/abo-abo/swiper/issues/295][#295]].
 336 *** Perform string-match in the original buffer
 337 The syntax for whitespace, separators etc. is different for modes.  See [[https://github.com/abo-abo/swiper/issues/298][#298]].
 338 ** New Features
 339 *** =swiper=
 340 **** Make line numbers into display properties
 341 Each candidate is now a single space plus the original string.  The
 342 display property of the single space holds the line number. This means
 343 that it's no longer possible to match line numbers in queries, which
 344 is a good thing if you're searching for numbers.
 345 **** Extend =swiper-font-lock-ensure=
 346 Add =mu4e-view-mode=, =mu4e-headers-mode=, =help-mode=,
 347 =elfeed-show-mode=, =emms-stream-mode=, =debbugs-gnu-mode=,
 348 =occur-mode=, =occur-edit-mode=, =bongo-mode=, =eww-mode=, =vc-dir-mode=.
 349 **** Add support for =evil-jumper/backward=
 350 See [[https://github.com/abo-abo/swiper/issues/268][#268]].
 351 **** Make compatible with =visual-line-mode=
 352 =swiper= will split the lines when =visual-line-mode= is on.  This is
 353 convenient for small buffers. For large buffers, it can be very slow,
 354 since =visual-line-mode= is slow.
 355 See [[https://github.com/abo-abo/swiper/issues/227][#227]].
 356 **** Add =swiper-toggle-face-matching=
 357 Bound to ~C-c C-f~.
 358 At each start of =swiper=, the face at point will be stored.
 359 Use this command to toggle matching only the candidates with that face.
 360 See [[https://github.com/abo-abo/swiper/issues/288][#288]].
 361 **** =push-mark= only if exited the minibuffer
 362 ~C-M-n~ and ~C-M-p~ will no longer push mark and annoy with messages.
 363 **** =ivy-resume= should restore the buffer for =swiper=
 364 See [[https://github.com/abo-abo/swiper/issues/302][#302]].
 365 **** Enable recursive =swiper= calls
 366 While you =swiper= buffer-1, you can switch out of the minibuffer into
 367 buffer-2 and call =swiper= again.  Exiting the second minibuffer will
 368 restore the first minibuffer.
 369
 370 To use this, you need to enable recursive minibuffers.
 371 #+begin_src elisp
 372 (setq enable-recursive-minibuffers t)
 373 #+end_src
 374
 375 It's also useful to indicate the current depth:
 376
 377 #+begin_src elisp
 378 (minibuffer-depth-indicate-mode 1)
 379 #+end_src
 380
 381 See [[https://github.com/abo-abo/swiper/issues/309][#309]].
 382 **** Fix for =twittering-mode=
 383 The =field= text property is now removed before inserting text into
 384 the minibuffer. This fixes the =swiper= problems with
 385 =twittering-mode=. See [[https://github.com/abo-abo/swiper/issues/310][#310]].
 386
 387
 388
 389
 390 *** =ivy=
 391 **** Add manual
 392 In the current state, the manual covers the most basic topics, like
 393 the minibuffer key bindings and the regexp builders.
 394 **** Make <left> and <right> behave as in fundamental-mode
 395 **** Truncate minibuffer prompts longer than window-width
 396 See [[https://github.com/abo-abo/swiper/issues/240][#240]].
 397 **** ~C-M-n~ should not leave the minibuffer
 398 Make sure that the minibuffer window remains selected as long as the
 399 completion hasn't finished.  For example, ~<f1> f~ to call
 400 =counsel-describe-function=, input "forward" and spam ~C-M-n~ to read
 401 the doc for each function that starts with "forward". The =*Help*=
 402 window popup would move the window focus, but this change moves it
 403 back to the minibuffer.
 404 **** Add =flx= sorting
 405 See [[https://github.com/abo-abo/swiper/issues/207][#207]].
 406 Since flx is costly, move the caching to an earlier point. This means
 407 immediate return for when the input hasn't changed, i.e. for ~C-n~ or
 408 ~C-p~. When =flx= is installed, and =(eq ivy--regex-function 'ivy--regex-fuzzy)=
 409 for current function (through =ivy-re-builders-alist=), then sort the final candidates with
 410 =ivy--flx-sort=.
 411
 412 In the worst case, when some error pops up, return the same list. In
 413 the best case sort the =cands= that all match =name= by closeness to
 414 =name=.
 415
 416 How to use:
 417 1. Have =flx= installed - =(require 'flx)= should succeed.
 418 2. Configure =ivy-re-builders-alist= appropriately to use =ivy--regex-fuzzy=.
 419
 420 For example:
 421
 422 #+begin_src elisp
 423 (setq ivy-re-builders-alist
 424       '((t . ivy--regex-fuzzy)))
 425 #+end_src
 426 **** Support hash tables
 427 Since =all-completions= also works for hash tables, no reason not to support them.
 428 **** Improve documentation of =ivy-count-format=
 429 Now possible to set it with Customize.
 430 **** Add =ivy-index-functions-alist=
 431 Customize this to decide how the index, i.e. the currently selected
 432 candidate, is updated with new input.
 433 For example, one strategy is not reset it to 0 after each change.
 434
 435 Another strategy, used for =swiper=, is to try to select the first
 436 appropriate candidate after (inclusive) the first previously selected
 437 candidate. This way, if you're typing something that matches what is
 438 currently selected, the selection won't change.
 439
 440 See [[https://github.com/abo-abo/swiper/issues/253][#253]].
 441 **** Add =ivy-virtual-abbreviate=
 442 The mode of abbreviation for virtual buffer names.
 443 **** Add =ivy-case-fold-search=
 444 Used to override =case-fold-search=. See [[https://github.com/abo-abo/swiper/issues/259][#259]].
 445 **** Add feedback for long-running async processes
 446 Each time 0.5s pass after the last input, if the external process
 447 hasn't finished yet, update minibuffer with the amount of candidates
 448 collected so far. This is useful to see that long running commands
 449 like =counsel-locate= or =counsel-ag= (when in a very large directory)
 450 aren't stuck.
 451 **** Promote =ivy-extra-directories= to defcustom
 452 **** Promote =ivy-sort-function-alist= to defcustom
 453 **** ~M-n~ should prefer url at point to symbol at point
 454 **** ~C-x C-f M-n~ calls =ffap-url-fetcher= when at URL
 455 **** Highlight modified file buffers with =ivy-modified-buffer= face
 456 This new face is blank by default, but you can use e.g.:
 457 #+begin_src elisp
 458 (custom-set-faces
 459  '(ivy-modified-buffer ((t (:background "#ff7777")))))
 460 #+end_src
 461 **** Work with =enable-recursive-minibuffers=
 462 Store the old =ivy-last= in case =ivy-read= is called while inside the
 463 minibuffer.  Restore it after =ivy-call=.
 464 **** Allow user-specified matched candidate sorting
 465 New defcustom =ivy-sort-matches-functions-alist=.
 466 See [[https://github.com/abo-abo/swiper/issues/269][#269]] [[https://github.com/abo-abo/swiper/issues/265][#265]] [[https://github.com/abo-abo/swiper/issues/213][#213]].
 467
 468 By default, Ivy doesn't sort the matched candidates, they remain in
 469 the same order as in the original collection. This option is the
 470 default, since it's fast and simple.
 471
 472 A small problem with this approach is that we usually want prefix
 473 matches to be displayed first. One solution to this is to input "^" to
 474 see only the prefix matches.
 475
 476 Now, another solution is to can set:
 477 #+begin_src elisp
 478 (setq ivy-sort-matches-functions-alist
 479       '((t . ivy--prefix-sort)))
 480 #+end_src
 481
 482 Here's another example of using this defcustom:
 483 #+begin_src elisp
 484 (add-to-list
 485      'ivy-sort-matches-functions-alist
 486      '(read-file-name-internal . ivy--sort-files-by-date))
 487 #+end_src
 488
 489 After this, during file name completion, most recently changed files
 490 will be ahead.
 491 **** =ivy-display-style=
 492 Adds fancy highlighting to the minibuffer.
 493 See [[https://github.com/abo-abo/swiper/issues/212][#212]], [[https://github.com/abo-abo/swiper/issues/217][#217]], .
 494 *** =ivy-hydra=
 495 **** Bind ~t~ to =toggle-truncate-lines=
 496 See [[https://github.com/abo-abo/swiper/issues/214][#214]].
 497 **** Bind ~a~ to =ivy-read-action=
 498 *** =ivy-switch-buffer=
 499 **** Make ~M-o r~ rename the buffer instead of switching.
 500 See [[https://github.com/abo-abo/swiper/issues/233][#233]].
 501 *** =counsel-locate=
 502 **** Allow customizing locate options
 503 See =counsel-locate-options=.
 504 The current setting is:
 505 #+begin_src elisp
 506 (setq counsel-locate-options '("-i" "--regex"))
 507 #+end_src
 508 **** Support OSX
 509 Use =open= instead of =xdg-open=.  Modify =counsel-locate-options= for
 510 OSX, since there =locate= doesn't support =--regex=.
 511 **** Use single quotes for the regex
 512 See [[https://github.com/abo-abo/swiper/issues/194][#194]].
 513 **** Add initial-input argument
 514 See [[https://github.com/abo-abo/swiper/issues/289][#289]].
 515 *** =counsel-org-tag=
 516 **** Now works in agenda
 517 See [[https://github.com/abo-abo/swiper/issues/200][#200]].
 518 *** =counsel-unicode-char=
 519 **** Add own history
 520 *** =counsel-M-x=
 521 **** Add "definition" action
 522 Use ~M-o d~ to jump to definition.
 523 **** Show =current-prefix-arg= in the prompt
 524 See [[https://github.com/abo-abo/swiper/issues/287][#287]].
 525 *** =counsel-find-file=
 526 **** Input '/sudo::' goes to current directory instead of root's home
 527 See [[https://github.com/abo-abo/swiper/issues/283][#283]].
 528 **** Fix directory validity check
 529 See [[https://github.com/abo-abo/swiper/issues/283][#283]] [[https://github.com/abo-abo/swiper/issues/284][#284]].
 530 **** Improve TRAMP support
 531 Selecting items after ~//~ now works properly.
 532 *** =counsel-git-grep=
 533 **** Use prefix arg to specify the shell command.
 534 Remember to use ~M-i~ to insert the current candidate into the
 535 minibuffer.
 536
 537 See [[https://github.com/abo-abo/swiper/issues/244][#244]].
 538 **** Allow =counsel-git-grep= -> =ivy-occur= -> =wgrep=
 539 Using ~C-c C-o~ (=ivy-occur=) while in =counsel-git-grep= will produce
 540 a =wgrep=-compatible buffer.
 541 **** =ivy-occur= gives full candidates
 542 This means that the =" | head -n 200"= speed-up isn't used and full
 543 candidates are returned.
 544 *** =counsel--find-symbol=
 545 **** Allow to jump back with pop-tag-mark
 546 Using ~C-.~ in:
 547
 548 - =counsel-describe-function=
 549 - =counsel-describe-variable=
 550 - =counsel-load-library=
 551
 552 will change the current buffer. The buffer and point can be restored
 553 with ~M-*~ (=pop-tag-mark=).
 554
 555 I also recommend this binding:
 556
 557 #+begin_src elisp
 558 (global-set-key (kbd "M-,") 'pop-tag-mark)
 559 #+end_src
 560 **** Resolve the name clash better
 561 When the symbol is both bound and fbound, prefer the fbound one,
 562 unless the =:caller= is =counsel-describe-variable=.
 563 *** =counsel-ag=
 564 **** Add =initial-directory=
 565 Support alternative initial directory which helps other packages call
 566 this function with their unique starting directory.
 567 **** Fix on Windows
 568 Using the "--vimgrep" argument improves things.
 569 ** New Commands
 570 *** =ivy-occur=
 571 Bound to ~C-c C-o~. Store the current completion session to its own
 572 buffer.  You can have an unlimited amount of these buffers.
 573 *** =ivy-avy=
 574 Bound to ~C-'~.
 575
 576 Speeds up selecting a candidate that's currently visible in the minibuffer.
 577 *** =ivy-kill-ring-save=
 578 Bound to ~M-w~.
 579
 580 When the region is active, call =kill-ring-save=.  Otherwise, store
 581 all selected candidates to the kill ring.
 582 *** =ivy-dispatching-call=
 583 Bound to ~C-M-o~.
 584
 585 This is a non-exiting version of ~M-o~ (=ivy-dispatching-done=).
 586 *** =ivy-read-action=
 587 Bound to ~C-M-a~. Select the current action. Don't call it yet.
 588 *** =swiper-multi=
 589 Use =swiper= in multiple buffers.
 590 See [[https://github.com/abo-abo/swiper/issues/182][#182]].
 591
 592 Basic usage tips for selecting multiple buffers:
 593
 594 - Use ~C-M-m~ (=ivy-call=) to add or remove one more buffer without exiting.
 595 - Use ~C-m~ (=ivy-done=) to add one last buffer.
 596 - Or use ~C-M-j~ (=ivy-immediate-done=) to finish without adding more buffers.
 597 - Hold ~C-M-n~ (=ivy-next-line-and-call=) to add a lot of buffers at once.
 598 *** =swiper-mc=
 599 Open multiple cursors at all selected candidates.
 600 *** =swiper-all=
 601 New command to launch =swiper= for all open file buffers.  Note that
 602 this can be excruciatingly slow if you don't clean up your buffer list
 603 often.
 604 *** =counsel-grep=
 605 This is essentially =swiper= for huge files. It's not as smooth as
 606 =swiper= for small files, but has a faster startup and faster matching
 607 for files that measure in megabytes.
 608 *** =counsel-git-grep-query-replace=
 609 Bound to ~M-q~. Perform =query-replace= on all matches in all buffers.
 610 *** =counsel-jedi=
 611 Complete Python symbols using Jedi.
 612 *** =counsel-cl=
 613 Complete Common Lisp symbols using SLIME.
 614 *** =counsel-yank-pop=
 615 Give completion for inserting from the kill ring.
 616 See =counsel-yank-pop-truncate= defcustom and [[https://github.com/abo-abo/swiper/issues/218][#218]].