doc string of tags-query-replace - args not described

doc string of tags-query-replace - args not described

[Drew Adams]

The args FILE-LIST-FORM, START, and END are not described in the doc
string.  The only cross reference sends you to `tags-file-name', which
is no help on these args either.


In GNU Emacs 22.1.1 (i386-mingw-nt5.1.2600)
 of 2007-06-02 on RELEASE
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --cflags -Ic:/gnuwin32/include'

Re: doc string of tags-query-replace - args not described

[Eli Zaretskii]

> From: "Drew Adams" <drew.adams@oracle.com>
> Date: Tue, 1 Jan 2008 23:11:42 -0800
> 
> The args FILE-LIST-FORM, START, and END are not described in the doc
> string.

Do they even matter?

RE: doc string of tags-query-replace - args not described

[Drew Adams]

> > The args FILE-LIST-FORM, START, and END are not described in the doc
> > string.
>
> Do they even matter?

No, they don't seem to.

The doc string should say that (they are ignored but are included for
compatibility, or whatever). If all calls to the function don't use them,
perhaps they can be eliminated (dunno).

And, for clarity, the last line of the function can be changed to

(tags-loop-continue t) instead of

(tags-loop-continue (or file-list-form t))

Re: doc string of tags-query-replace - args not described

[Eli Zaretskii]

> From: "Drew Adams" <drew.adams@oracle.com>
> Cc: <bug-gnu-emacs@gnu.org>
> Date: Sat, 26 Jan 2008 08:20:08 -0800
> 
> > > The args FILE-LIST-FORM, START, and END are not described in the doc
> > > string.
> >
> > Do they even matter?
> 
> No, they don't seem to.
> 
> The doc string should say that (they are ignored but are included for
> compatibility, or whatever).

Done.