Re: [Emacs-diffs] emacs-25 035bd81: Update documentation for Dired search and replace

[Dmitry Gutov]

On 01/23/2016 09:53 AM, Eli Zaretskii wrote:
> branch: emacs-25
> commit 035bd8159fe5bcea15eacc8a23ab54f4bc3b6f17
> Author: Eli Zaretskii <address@hidden>
> Commit: Eli Zaretskii <address@hidden>
>
>      Update documentation for Dired search and replace
>
>      * doc/emacs/dired.texi (Operating on Files): Update descriptions
>      of 'A' and 'Q' now bound to 'dired-do-find-regexp' and
>      'dired-do-find-regexp-and-replace'.
>
>      * etc/NEWS: Mention xref-related changes in Dired.

Looks good overall, thanks.

> +(@code{dired-do-find-regexp}).

> +This command is a variant of @code{xref-find-apropos}
> +(@pxref{Identifier Search}), it displays the @file{*xref*} buffer,
> +where you can navigate between matches and display them as needed
> +using the commands described in @ref{Xref Commands}.

That's rather wrong: dired-do-find-regexp performs regexp-search inside 
the files.

xref-find-apropos, on the other hand, performs regexp search inside the 
definitions index (obarray for elisp backend, and TAGS file for etags 
backend).

Although I get that you might want to avoid mentioning 
project-find-regexp here, and there's no other suitable command to 
compare to.