From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#24312: 25.1.50; doc string of `tags-query-replace' - wrong signature Date: Fri, 26 Aug 2016 11:16:23 -0700 (PDT) Message-ID: <47aeccdb-a603-498b-9e4e-9814741e0b33@default> References: <83mvjzcu13.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1472235440 16450 195.159.176.226 (26 Aug 2016 18:17:20 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 26 Aug 2016 18:17:20 +0000 (UTC) Cc: 24312-done@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Aug 26 20:17:17 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bdLgq-0003lP-8v for geb-bug-gnu-emacs@m.gmane.org; Fri, 26 Aug 2016 20:17:16 +0200 Original-Received: from localhost ([::1]:33354 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bdLgn-0004R1-1R for geb-bug-gnu-emacs@m.gmane.org; Fri, 26 Aug 2016 14:17:13 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49284) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bdLgg-0004Qj-JW for bug-gnu-emacs@gnu.org; Fri, 26 Aug 2016 14:17:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bdLgc-0006M9-BO for bug-gnu-emacs@gnu.org; Fri, 26 Aug 2016 14:17:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:43963) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bdLgc-0006Lz-7y for bug-gnu-emacs@gnu.org; Fri, 26 Aug 2016 14:17:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bdLgb-00024E-SM for bug-gnu-emacs@gnu.org; Fri, 26 Aug 2016 14:17:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 26 Aug 2016 18:17:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24312 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: wontfix Original-Received: via spool by 24312-done@debbugs.gnu.org id=D24312.14722353967912 (code D ref 24312); Fri, 26 Aug 2016 18:17:01 +0000 Original-Received: (at 24312-done) by debbugs.gnu.org; 26 Aug 2016 18:16:36 +0000 Original-Received: from localhost ([127.0.0.1]:41675 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bdLgB-00023X-Qq for submit@debbugs.gnu.org; Fri, 26 Aug 2016 14:16:35 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:48771) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bdLgA-00023K-B5 for 24312-done@debbugs.gnu.org; Fri, 26 Aug 2016 14:16:34 -0400 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u7QIGS3Z025377 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 26 Aug 2016 18:16:28 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id u7QIGQP6029042 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 26 Aug 2016 18:16:26 GMT Original-Received: from abhmp0013.oracle.com (abhmp0013.oracle.com [141.146.116.19]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u7QIGPhQ030304; Fri, 26 Aug 2016 18:16:25 GMT In-Reply-To: <83mvjzcu13.fsf@gnu.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6753.5000 (x86)] X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:122695 Archived-At: > > The doc string says this (correctly): > > > > Fifth and sixth arguments START and END are accepted, for compatibilit= y > > with =E2=80=98query-replace-regexp=E2=80=99, and ignored. >=20 > So it's obviously deliberate. >=20 > > The doc cannot reference optional args START and END unless they are in > > the signature. >=20 > They are optional, so yes, the doc can do that. >=20 > Closing. Suit yourself. FYI, searching the doc strings of all functions defined in my session for "ignored", I find NONE that show a signature without an optional argument that is mentioned as being ignored. ZERO. On the other hand, I find all of these functions whose doc strings state that an optional argument is ignored and that show the ignored argument in the signature: after-find-file cvs-quikdir dframe-set-timer dired-revert gnus-agent-regenerate gnus-delay-initialize iso-german iso-gtex2iso iso-iso2duden iso-iso2gtex iso-iso2sgml iso-iso2tex iso-sgml2iso iso-spanish iso-tex2iso pcomplete-opt url-copy-file view-buffer-other-frame view-buffer-other-window widget-image-insert