[elpa] master 20744aa 337/348: doc/Changelog.org: Prepare for 0.9.0

[Oleh Krehel]

branch: master
commit 20744aa09167106abcbaaee514699891af625a87
Author: Oleh Krehel <address@hidden>
Commit: Oleh Krehel <address@hidden>

    doc/Changelog.org: Prepare for 0.9.0
---
 doc/Changelog.org | 585 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 585 insertions(+)

diff --git a/doc/Changelog.org b/doc/Changelog.org
index 9013ca3..967d061 100644
--- a/doc/Changelog.org
+++ b/doc/Changelog.org
@@ -1941,4 +1941,589 @@ By default, the splitting predicate is 300K bytes in a 
file.
 <br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>
 <br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>
 #+END_EXPORT
+* 0.9.0
+:PROPERTIES:
+:CUSTOM_ID: 0.9.0
+:END:
+** Fixes
+:PROPERTIES:
+:CUSTOM_ID: fixes
+:END:
+*** doc
+
+**** Fixed typos in the doc
+See #497, #809.
+**** Added =ivy-format-function= to the doc
+See #577.
+**** Added info on generating the doc
+See #601.
+**** Added info on associating values
+See #714.
+**** Update package names on ELPA/MELPA
+See #833.
+*** =ivy--filter= Recompute index after filter
+See #491.
+*** =ivy-hydra= is now a separate package on MELPA
+See #464, #512.
+*** =counsel-load-theme=
+Add noconfirm flag.
+*** =counsel-find-file=
+**** Improve stability on arcane systems
+It can happen that =(all-completions "" 'read-file-name-internal)= may
+fail on systems with symlinks. I think it's related to the file
+functions trying to compute occupied space. In any case, a plain
+=directory-files= is roughly the equivalent and is less likely to fail.
+**** Check compat between preselect and initial-input
+See #514, #515.
+**** Prevent expand-file-name nil
+See #518.
+**** Don't crash if default-directory is nil
+See #586.
+**** Allow to ~C-y~ a "/ssh:" file
+**** Press ~M-n~ on issue works for newer magit version
+See #692.
+**** Fix when initial input is a file name
+See #744.
+**** Account for =file-name-directory= returning nil
+See #780.
+**** Fix ~RET~ on no input
+See #782.
+**** Fix ~RET~ when file exists
+See #792.
+*** =counsel--gg-sentinel=
+Check for an additional 141 return code.
+*** =ivy-completion-in-region-action=
+Remove string properties, see #517.
+Remove =with-ivy-window=, see #928.
+*** =ivy-completion-in-region=
+Fix double insert bug.
+Fix common length bug. See #528.
+Remove =:require-match=, see #907.
+*** =ivy-immediate-done=
+Update docstring, see #525.
+*** =swiper-font-lock-exclude=
+Add =forth-mode=, see #526.
+Add =forth-block-mode=, see #527.
+Add =bookmark-bmenu-mode=.
+Add =nix-mode=, see #879.
+Add =circe-mode=, see #900, #901
+*** =ivy-read=
+**** Document all args
+See #533.
+**** Use predicate when reading file names
+See #804.
+*** =counsel-grep-or-swiper=
+Don't grep on compressed files. See #536.
+*** =counsel-git=
+**** Add a better error message.
+See #537.
+**** Add ~x~ action
+To open externally.
+*** =colir-parse-color=
+Fix color parsing in terminal. See #541 and #543.
+*** =counsel-imenu=
+**** Improve readability
+See #558.
+**** Force rescan if requested
+See #631.
+*** =counsel-rhythmbox=
+No longer depends on =helm-rhythmbox=.
+*** =counsel-M-x=
+**** Fix interaction with =repeat=
+See #564.
+**** Preserve =last-command=
+See #891, #893.
+*** =swiper=
+**** Fix "foo!bar" syntax
+See #565.
+**** Now respects =ivy-re-builders-alist=
+See #613.
+
+Example:
+#+begin_src
+(setq ivy-re-builders-alist
+          '((swiper . ivy--regex-fuzzy)
+            (t . ivy--regex-plus)))
+#+end_src
+*** =ivy-minibuffer-map=
+**** Move =ivy-toggle-regexp-quote= from ~M-q~ to ~M-r~.
+See #566.
+**** Remap scroll-up/down-command
+Instead of assigning ~C-v~ / ~M-v~ so page up/down works.
+See #797, #798.
+**** Remap =backward-delete-char-untabify= to =ivy-backward-delete-char=
+**** Rebind ~C-v~ and ~M-v~
+The ultimate solution to have PgUp and PgDown and whatever else was
+mapped to =scroll-up-command= bound in =ivy-minibuffer-map=. While
+still having the standard ~C-v~ and ~M-v~ bindings.
+
+See #797, #798, #535.
+*** =swiper-avy=
+Require avy, see #593.
+*** =counsel-linux-app=
+**** Don't quit on bad data
+See #604.
+**** Check if dir exists
+See #896.
+*** =counsel-locate=
+**** Make =counsel-locate-action-extern= interactive
+See #605.
+**** Add w32 support to =counsel-locate-action-extern=
+See #607, #688.
+*** =ivy-switch-buffer=
+**** Reset index to 0 on input
+See #522, #513.
+*** =ivy-resume=
+The original =default-directory= will be restored, see #591.
+*** =counsel-yank-pop=
+Fix candidates not showing sometimes.
+*** =ivy-occur-press=
+Pass the whole cons cell to action, see #634.
+*** =ivy-remote=
+Use a lighter color for dark themes, see #646.
+*** =counsel-ag=
+Use sync on remote. See #669.
+Add missing parameter. See #858, #861
+*** =swiper-multi=
+Fix regression, See #673.
+Don't use virtual buffers, See #705.
+*** =counsel-recoll=
+Add =shell-quote-argument=. See #713.
+*** =ivy-call=
+Set =default-directory=, see #717, #760, #779, #810.
+Recursive logic, see #924, #937.
+*** =counsel-info-lookup-symbol=
+Fix doc, see #721.
+Add preselect, see #722.
+*** =ivy--minibuffer-setup=
+Fix =max-mini-window-height=. See #732.
+*** Recursive minibuffers with two emacsclients
+See #738
+*** =ivy-fixed-height-minibuffer=
+Add correction. See #737.
+*** =ivy-switch-buffer-other-window=
+Obey =ivy-ignore-buffers=. See #745.
+*** =counsel-grep=
+Quote =:preselect=.
+*** shrink minibuffer after reading actions
+See #764, #402
+*** =ivy--regex-ignore-order=
+Ensure it returns legal regexps. See #765.
+*** =ivy--virtual-buffers=
+Don't modify recentfs or bookmarks. See #821.
+*** =ivy--reset-state=
+Simplify. See #827.
+*** =ivy--occur-insert-lines=
+Scroll to first command. See #829.
+*** =ivy--format-minibuffer-line=
+Fix for =ivy-display-style= nil. See #828.
+*** =counsel-ace-link=
+Use =cdr= for action. See #835.
+*** =ivy--flx-sort=
+Improve. See #843.
+*** =ivy-sort-functions-alist=
+Improve. See #870.
+*** =counsel-org-tag-action=
+Perform in the minibuffer. See #890.
+*** =ivy-help-file=
+Define with =defconst=, see #938.
+*** =ivy-partial=
+Fix for =:dynamic-collection=.
+See #946.
+** New Features
+:PROPERTIES:
+:CUSTOM_ID: new-features
+:END:
+*** =counsel-mode-map=
+**** Bind =counsel-info-lookup-symbol=
+Substitutes =info-lookup-symbol=, see #493.
+*** =ivy-add-actions=
+This is a convenience extension to the existing =ivy-set-actions=.
+See #470.
+*** =ivy-sort-file-function-using-ido=
+Extends the options for sorting file names. See #498.
+*** Make key binding for other window action consistent
+By default, ~M-o j~ will select the file or buffer in other window, for
+both =ivy-switch-buffer= and =counsel-find-file=.
+*** =counsel-git-grep-cmd-default=
+The initial value for =counsel-git-grep-cmd=.
+*** =ivy-action-wrap=
+Set this to have =ivy-next-action= and =ivy-prev-action= wrap around.
+*** =ivy-set-prompt-text-properties-function=
+An advanced override of the prompt string.
+*** =ivy-completion-in-region-action=
+Add support for =multiple-cursors=, see #547.
+*** =ivy-read=
+**** Facilitate sorting of cons cells
+See #554.
+#+begin_src elisp
+(defvar ivy-sorter-data '(("b 1" . 1) ("a 2" . 2) ("d 0" . 0) ("c 5" . 5)))
+
+(defun isn (a b)
+  (< (cdr a) (cdr b)))
+
+(add-to-list 'ivy-sort-functions-alist '(ivy-sorter . isn))
+
+(ivy-read "string: " ivy-sorter-data
+          :sort t
+          :caller 'ivy-sorter)
+#+end_src
+**** Add prefix arg for action functions
+See #552.
+
+Single actions:
+| C-m     | ivy-done             | store prefix |
+| M-o     | ivy-dispatching-done | store prefix |
+| C-j     | ivy-alt-done         | store prefix |
+| C-M-j   | ivy-immediate-done   | store prefix |
+| TAB TAB | ivy-partial-or-done  | unsupported  |
+| C-'     | ivy-avy              | unsupported  |
+
+Multiple actions:
+| C-M-m | ivy-call                   | store prefix, type prefix again for 
next call |
+| C-M-o | ivy-dispatching-call       | store prefix, type prefix again for 
next call |
+| C-M-n | ivy-next-line-and-call     | store prefix, type prefix again for 
next call |
+| C-M-p | ivy-previous-line-and-call | store prefix, type prefix again for 
next call |
+
+An example application:
+
+no prefix prints first number in a message-box
+one prefix prints last number in a message-box
+numeric prefix selects the index to print in a message-box
+#+begin_src elisp
+(ivy-read "choose: " '(("a" 1 2 3)
+                       ("b" 3 4 5))
+          :action
+          (lambda (x)
+            (message-box "%s"
+                         (cond
+                           ((null ivy-current-prefix-arg)
+                            (elt x 0))
+                           ((equal '(4) ivy-current-prefix-arg)
+                            (car (last x)))
+                           (t
+                            (elt x (prefix-numeric-value 
ivy-current-prefix-arg)))))))
+#+end_src
+
+
+**** Breaking change for alist type collection actions
+The action will be called with collection's =ITEM=, instead of =(cdr
+ITEM)= like before. This allows to simplify the logic of complex action
+functions: they don't have to look up the full item by string in their
+own collection, moreover they don't have to know anything about their
+collection.
+**** Implement unique index for alist completion
+The uniqueness assumption is that the completion system is passed a
+list of /unique/ strings, of which one (or more) are selected.
+
+Unlike plain string completion, alists may require violating the
+uniqueness assumption: there may be two elements with the same =car= but
+different =cdr=. Example: C function declaration and definition for tag
+completion.
+
+Until now, whenever two equal strings were sent to =ivy-read=, only the
+first one could be selected. Now, each alist car gets an integer index
+assigned to it as a text property ='idx=. So it's possible to
+differentiate two alist items with the same key.
+**** Make =with-ivy-window= not necessary in the action function
+This allows for a lot of simplification, e.g. use =insert= instead of
+=(lambda (x) (with-ivy-window (insert x)))=.
+
+See #639.
+
+*** =swiper=
+**** Add option for swiper line number to be searchable
+See =swiper-include-line-number-in-search= and #562.
+**** Restore window position after using swiper.
+Relevant for high settings of =scroll-conservatively=.
+See #643.
+**** Improve fuzzy highlight
+If you've set the regex builder to fuzzy (non-default), you'll get a
+highlight quality on par with the default one.  See #651, #653.
+**** Add =char-fold-to-regexp=
+See #622.
+**** Add compatibility with =evil-ex-search=
+See #887
+**** Apply =evil= search highlighting
+See #888
+**** Set =evil-ex-search-direction=
+See #947
+*** =ivy-set-prompt=
+Allow to set the prompt using the =:caller= as key.
+*** =ivy-switch-buffer-faces-alist=
+Allow to customize faces in =ivy-switch-buffer= by the mode of each buffer.
+
+Example:
+#+begin_src elisp
+(setq ivy-switch-buffer-faces-alist
+      '((emacs-lisp-mode . swiper-match-face-1)
+        (dired-mode . ivy-subdir)
+        (org-mode . org-level-4)))
+#+end_src
+*** =counsel-find-file=
+**** Add binding to jump to a bookmarked directory without quit
+Press ~M-o b~ to set the current directory to one of the virtual
+buffers' directories. You continue to select a file from that directory.
+
+See #531.
+*** =counsel-ag=
+**** Extend more
+See #576.
+**** Add =counsel-git-cmd=
+See #590.
+**** Prompt for extra args when using prefix arg
+See #774.
+**** Support limiting in files
+See #820, #822, #823.
+*** =ivy-switch-buffer=
+**** Add =ivy-sort-function-buffer=
+Puts e.g. the =*scratch*= buffer ahead of the =misc= buffer if the input
+is "sc", since it's almost like a prefix match.
+
+See #595.
+**** Sort virtual buffers after open buffers
+See #706, #743.
+*** =swiper-all=
+**** Is now async
+This means extremely fast startup time.
+
+Additionally, the feedback to input is quite fast even with a hundred
+buffers. This is because, unlike =swiper=, line numbers are not
+computed. Computing line numbers, while situationally useful, is
+really slow for huge buffers, and even slower for dozens of huge
+buffers.
+
+See #620.
+**** Press ~M-q~ for query-replace
+See #623.
+**** Ignore TAGS buffers
+See #787
+**** Consider magit stash buffers
+See #819
+**** Fix =case-fold-search=
+See #880
+
+*** =counsel-git-grep=
+**** Support custom per-project commands
+The idea is to grep several Git repositories at once. For example, my
+Emacs config is a Git repository with many Git submodule repositories
+inside.
+
+When used with ~C-u~, and inside =counsel-git-grep-projects-alist=, use
+the corresponding command instead.  Additionally,
+=counsel-git-grep-proj-function= is used.
+
+For a possible implementation of the custom git-grep command, see:
+https://github.com/abo-abo/oremacs/commit/c7effdb94749dc600b1204ea7a9db319ebdb0f00
+
+See #616.
+**** Reveal text hidden in outlines
+**** Works with "Git for Windows" and native Emacs build
+**** Fix for files with spaces in the name
+See #700.
+**** Fix ~g~ (=counsel-git-grep-occur=)
+Things go wrong when `ivy-text' is changed from the original value.
+Extract =ivy-text= from the buffer name.
+
+Quote the directory name. See #811.
+**** Update quoting
+See #876.
+
+*** =ivy-occur-mode=
+**** ~RET~ now switches to candidate window
+**** =read-only-mode= is enabled
+See #720
+**** Set =view-read-only= locally
+See #789
+**** Run =wgrep-setup=
+See #904
+*** =counsel-git-log=
+**** Add =counsel-git-log-cmd=
+Allows to customize the command, see #652.
+*** =counsel-yank-pop=
+**** Add =counsel-yank-pop-separator=
+Allows to customize the separator.
+See #660.
+*** =counsel-unicode-char=
+**** Add leading zeros to the display
+See #662.
+**** Support universal argument
+See #868
+*** =ivy-flip=
+When non-nil, insert the candidates into =LV= window, instead of the
+minibuffer. While this is an experimental feature, it shows off the
+flexibility of Ivy's display pipeline. While the input is quite firmly
+restricted to the minibuffer, the display does not have to be.  Which
+means it can be moved no another window, perhaps even a popup overlay.
+
+Maybe at some point in the future Ivy will support the style of popups
+that environments like Eclipse or KDevelop offer, or at least the
+likes of =auto-complete-mode= and =company-mode= in Emacs.
+*** =counsel-mode=
+Press ~C-r~ while inside the minibuffer during =eval-expression= or
+=shell-command= to get completion for history.
+*** completion at point
+- =ivy-display-functions-alist= ::
+    New defcustom, which decides how to display the candidates.
+=ivy-completion-in-region= will use completion at point by default.
+
+Related: #707, #712, #788
+*** =ivy-magic-tilde=
+New defcustom. Decide if =~= or =~/= should cd home.
+
+See #687, #679.
+*** =counsel-pt=
+Add =initial-input= arg. See #757.
+*** =counsel-grep-post-action-hook=
+New hook for counsel-ag/grep/pt. See #800, #751.
+*** =counsel-bookmark-avoid-dired=
+When non-nil and a directory is selected from =counsel-bookmark=,
+forward the choice to =counsel-find-file= instead of opening a =dired=
+buffer.
+See #813.
+*** =ivy-highlight-functions-alist=
+Customize the highlighters. See #691, #654, #827.
+*** =counsel-linux-apps-directories=
+Customize the search path for =counsel-linux-app=.
+*** =counsel-load-library=
+**** Allow to find library with an action
+See #873.
+*** =ivy-completing-read-handlers-alist=
+New defcustom. See #892.
+*** =ivy-completing-read=
+**** Set =:caller= to =this-command=
+Improves sorting customization. See #899.
+**** Don't =:require-match= for null
+See #909.
+*** Alternative action list ~M-o~ using Hydra
+Not hiding the candidates and using a single line for actions results
+in a more distraction-free experience.
+
+Use this code to turn it on:
+#+begin_src elisp
+(require 'ivy-hydra)
+#+end_src
+*** =ivy-case-fold-search=
+**** Add an additional value ='always=
+If the value of ivy-case-fold-search is set to 'always, the search is
+always case-insensive, regardless of the input.
+
+See #916.
+*** =swiper-avy=
+**** Work with more regexp builders
+See #932.
+*** =swiper-goto-start-of-match=
+New defcustom. When non-nil, swiper default action will go to the
+beginning of the match instead of on its end. This behavior is
+inspired by vim's and evil's way of searching.
+
+See #944, #942.
+** New Commands
+:PROPERTIES:
+:CUSTOM_ID: new-commands
+:END:
+*** =counsel-company=
+Picks up company's candidates and inserts the result into the buffer.
+See #331, #547.
+*** =counsel-bookmark=
+Completion for =bookmark-jump=.
+
+Can delete and rename bookmarks, see #758.
+*** =counsel-set-variable=
+Completion for setting a variable to a value.
+See #544, #546, #549, #550, #556.
+*** =counsel-hydra-heads=
+Call a head of the current/last hydra by name.
+See #696
+*** =ivy-push-view=
+And =ivy-pop-view=.
+
+1. Use =ivy-push-view= to store a view - your current window tree.  This
+   contains: all windows on the current frame, and their configuration
+   w.r.t. horizontal or vertical splits. The point positions in each
+   window are stored as well.
+
+2. Use =ivy-switch-buffer= to select stored views.
+
+3. Use =ivy-pop-view= to delete a stored view that you don't want any
+   more.
+
+See #584.
+*** =counsel-semantic=
+Completion for semantic tags.
+*** =counsel-describe-face=
+See #585, #703.
+*** =counsel-outline=
+Completion for outlines in the current buffer.
+*** =counsel-file-jump=
+Jump to a file from a list of all files in the current directory, see #609, 
#610.
+*** =counsel-dired-jump=
+Like, =counsel-file-jump=, but for directories.
+*** =counsel-dpkg=
+Completion for =dpkg -l=.
+*** =counsel-recentf=
+Renamed from =ivy-recentf=, see #624.
+
+Added actions in #701:
+
+- ~j~ for =find-file-other-window=
+- ~x~ for =counsel-find-file-extern=
+
+Remove text properties, see #770.
+
+*** =counsel-shell-command-history=
+Search through history in =shell-mode=. See #689.
+
+When =counsel-mode= is on, ~M-! C-r~ will call
+=counsel-shell-command-history=.
+*** =counsel-rpm=
+Call the =rpm= shell command. See #695.
+*** =counsel-rg=
+Grep for a string in the current directory using =rg=.
+Use =counsel-rg-base-command= to customize.
+See #784, #785, #795, #796.
+*** =counsel-find-library=
+A helpful and unsurprising alternative to using ~C-.~ with
+=counsel-load-library=.
+See #794, #801.
+*** =counsel-colors-web=
+See #815
+*** =counsel-colors-emacs=
+See #815, #921
+*** =counsel-faces=
+See #815
+*** =counsel-command-history=
+See #826
+*** =counsel-org-agenda-headlines=
+See #825
+*** =counsel-mark-ring=
+See #834
+*** =ivy-rotate-sort=
+Modify =ivy-sort-functions-alist= to allow a list of sorting functions
+to apply to a collection. The car of this list is the current
+one. =ivy-rotate-sort= then rotates this list through the different
+possibilities. Bound to ~C-c C-s~. Here is a simple example to
+illustrate.
+
+#+begin_src elisp
+(setq ivy-sort-functions-alist
+      '((read-file-name-internal .
+                                (ivy-sort-file-function-default string-lessp 
string-greaterp))
+       (internal-complete-buffer . nil)
+       (counsel-git-grep-function . nil)
+       (Man-goto-section . nil)
+       (org-refile . nil)
+       (t . string-lessp)))
+#+end_src
+
+~M-x~ =find-file= ~RET C-c C-s~ now switches from the default sorting to
+using =string-lessp=. ~C-c C-s~ again switches to =string-greaterp= and so
+on.
+
+See #845, #927.
 
+*** =counsel-package=
+Manage packages. Allows installing, deleting, describing etc.
+See #869, #872.
+*** =counsel-irony=
+Inline C++ completion using Irony.