bug#20654: 25.0.50; doc string of `query-replace': Describe interactive behavior first

[Lars Ingebrigtsen]

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

> Describe the command first of all from the point of view of an
> interactive user, and only secondarily from the point of view of a Lisp
> programmer.
>
> The description starts out correctly, in that vein.  But it does not
> describe the use of a prefix arg.  An Emacs user must wade through the
> entire description, including specifics about each of the Lisp
> parameters, before getting to the info about the prefix arg.  And even
> then s?he must read attentively or s?he will miss it.
>
> This StackExchange question, as well as comments and answers provided by
> fairly experienced Emacs[Lisp] users, supports the need to fix this:
> http://emacs.stackexchange.com/q/12688/105

I've now moved it earlier and rephrased it.

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