summaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
Diffstat (limited to 'README.org')
-rw-r--r--README.org17
1 files changed, 12 insertions, 5 deletions
diff --git a/README.org b/README.org
index 9bf5593..a010932 100644
--- a/README.org
+++ b/README.org
@@ -1094,11 +1094,18 @@ Besides those exporters and candidate collectors, the =embark-consult=
package provides many subtle tweaks and small integrations between
Embark and Consult. Some examples are:
-- The asynchronous search commands will start in the directory
- associated to the Embark target if that target is a file, buffer,
- bookmark or Emacs Lisp library.
-
- - For all other target types, a Consult search command (asynchronous
+- When used as actions, the asynchronous search commands will search
+ only the files associated to the targets: if the targets /are/ files,
+ it searches those files; for buffers it will search either the
+ associated file if there is one, else all files in the buffer's
+ =default-directory=; for bookmarks it will search the file they point
+ to, same for Emacs Lisp libraries. This is particularly powerful
+ when using =embark-act-all= to act on multiple files at once, for
+ example you can use =consult-find= to search among file /names/ and then
+ =embark-act-all= and =consult-grep= to search within the matching files.
+
+ - For all other target types, those that do not have a sensible
+ notion of associated file, a Consult search command (asynchronous
or not) will search for the text of the target but leave the
minibuffer open so you can interact with the Consult command.