> From: Joseph Turner <jos...@breatheoutbreathe.in>
> Cc: Brian Green <bria...@gmail.com>,  r...@gnu.org,  72...@debbugs.gnu.org,
>   j...@linkov.net
> Date: Sat, 24 Aug 2024 10:09:10 -0700
> 
> Eli Zaretskii <e...@gnu.org> writes:
> 
> >> From: Brian Green <bria...@gmail.com>
> >> Date: Sat, 24 Aug 2024 01:29:11 -0700
> >> Cc: Eli Zaretskii <e...@gnu.org>, r...@gnu.org, 72...@debbugs.gnu.org, 
> >> j...@linkov.net
> >> 
> >> I submitted this "bug" report because I mis-interpreted the docstring,
> >> and because I was approaching this command with a preconceived idea
> >> about how it should work.  I think Eli is right.  I can't think of a
> >> good reason why I would need to stipulate a certain behavior before
> >> calling the command which I can already get at any point while the
> >> command is running.
> >
> > The doc string indeed could use some improvements, at least in stating
> > explicitly what happens in interactive usage and what only when called
> > from Lisp.
> 
> See patch.  Is the text wrapping acceptable?  It looks too long in
> paragraphs.el but good in the *Help* buffer.

Is this instead of the code change or in addition to it?

In any case, I think it would be better to say

  Noninteractively, if optional argument NO-QUERY is non-nil, make changes
  without asking for confirmation.  To achieve the same effect
  interactively, press \\<query-replace-map>\\[automatic] at the first...



  • bug#72704:... Eli Zaretskii
    • bug#7... Bug reports for GNU Emacs, the Swiss army knife of text editors
      • b... Eli Zaretskii
        • ... Bug reports for GNU Emacs, the Swiss army knife of text editors
          • ... Eli Zaretskii
            • ... Brian Green

Reply via email to