[elpa] externals/consult 4a0d097435 2/3: Deprecate consult-multi-occur

[ELPA Syncer]

branch: externals/consult
commit 4a0d097435125238bfa2fc0853e780f58f90251e
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>

    Deprecate consult-multi-occur
    
    `consult-line-multi` is a better and more interactive command. Furthermore 
the
    `completing-read-multiple` buffer selection of `consult-multi-occur` offers 
no
    benefits over the regexp selection of built-in `multi-occur` itself. 
Selecting
    using `completing-read-multiple` may be even less convenient.
---
 CHANGELOG.org | 1 +
 README.org    | 4 ----
 consult.el    | 2 ++
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.org b/CHANGELOG.org
index 643555f366..722e18e522 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -19,6 +19,7 @@
 - Org 9.6: Support new =org-fold-core= API (both overlays and text-properties)
 - Support abbreviated file names in =recentf-list=, see 
=recentf-filename-handler=.
 - Deprecate =consult-apropos=
+- Deprecate =consult-multi-occur=
 
 * Version 0.20 (2022-10-16)
 
diff --git a/README.org b/README.org
index cf66fba1f8..e652424edc 100644
--- a/README.org
+++ b/README.org
@@ -201,7 +201,6 @@ their descriptions.
 
 #+findex: consult-line
 #+findex: consult-line-multi
-#+findex: consult-multi-occur
 #+findex: consult-keep-lines
 #+findex: consult-focus-lines
 - =consult-line=: Enter search string and select from matching lines.
@@ -213,8 +212,6 @@ their descriptions.
   search across project buffers. If invoked with a prefix argument search 
across
   all buffers. The candidates are computed on demand based on the input. The
   command behaves like =consult-grep=, but operates on buffers instead of 
files.
-- =consult-multi-occur=: Replacement for =multi-occur= which uses
-  =completing-read-multiple=.
 - =consult-keep-lines=: Replacement for =keep/flush-lines= which uses the 
current
   completion style for filtering the buffer. The function updates the buffer
   while typing. In particular =consult-keep-lines= can narrow down an exported
@@ -789,7 +786,6 @@ configuration examples.
            ("M-s r" . consult-ripgrep)
            ("M-s l" . consult-line)
            ("M-s L" . consult-line-multi)
-           ("M-s m" . consult-multi-occur)
            ("M-s k" . consult-keep-lines)
            ("M-s u" . consult-focus-lines)
            ;; Isearch integration
diff --git a/consult.el b/consult.el
index 3edc4b5628..e18f2130e0 100644
--- a/consult.el
+++ b/consult.el
@@ -2853,6 +2853,8 @@ See `multi-occur' for the meaning of the arguments BUFS, 
REGEXP and NLINES."
                 (occur-read-primary-args)))
   (occur-1 regexp nlines bufs))
 
+(make-obsolete 'consult-multi-occur 'consult-line-multi "0.20")
+
 ;;;;; Command: consult-outline
 
 (defun consult--outline-candidates ()