diff options
Diffstat (limited to 'embark.texi')
-rw-r--r-- | embark.texi | 15 |
1 files changed, 11 insertions, 4 deletions
diff --git a/embark.texi b/embark.texi index d512cf5..cc41bf4 100644 --- a/embark.texi +++ b/embark.texi @@ -1312,13 +1312,20 @@ Embark and Consult. Some examples are: @itemize @item -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. +When used as actions, the asynchronous search commands will search +only the files associated to the targets: if the targets @emph{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 +@samp{default-directory}; for bookmarks it will search the file they point +to, same for Emacs Lisp libraries. This is particularly powerful +when using @samp{embark-act-all} to act on multiple files at once, for +example you can use @samp{consult-find} to search among file @emph{names} and then +@samp{embark-act-all} and @samp{consult-grep} to search within the matching files. @itemize @item -For all other target types, a Consult search command (asynchronous +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. @end itemize |