bug#55050: 27.2; Doc strings for commands that do query-replacements

[Lars Ingebrigtsen]

Drew Adams <drew.adams@oracle.com> writes:

> This is about the doc of commands, such as
> `dired-do-find-regexp-and-replace', that use a query-replace dialog.
> There are a bunch of such commands now.  For the most part, they don't
> tell you anything about what to expect, in terms of a dialog.  In
> particular, they don't reference the doc of `query-replace`, which is
> (at least) where the dialog should be described.

I've now linked the latter from the doc string of the former.

> The only saving grace is that there's a prompt that suggests that if you
> hit `?' you might get some information about what you can do.  Assuming
> you notice that prompt, of course.
>
> The doc of all such commands should, directly or indirectly, tell you
> about the keys you can use and what they do - what you learn by hitting
> `?'.

I don't think that would be particularly useful.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no