GNU bug report logs - #81492
30.2; `tags-query-replace' signature doesn't match doc or byte-compiler

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Reported by: "Drew Adams" <drew00000001@HIDDEN>; Keywords: notabug; dated Sat, 25 Jul 2026 16:20:02 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.
Added tag(s) notabug. Request was from Eli Zaretskii <eliz@HIDDEN> to control <at> debbugs.gnu.org. Full text available.

Message received at 81492 <at> debbugs.gnu.org:


Received: (at 81492) by debbugs.gnu.org; 25 Jul 2026 16:36:16 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Jul 25 12:36:16 2026
Received: from localhost ([127.0.0.1]:52638 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1wnfMF-0003SX-Ma
	for submit <at> debbugs.gnu.org; Sat, 25 Jul 2026 12:36:16 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:39340)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <eliz@HIDDEN>)
 id 1wnfMC-0003Rf-BR; Sat, 25 Jul 2026 12:36:13 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1wnfM5-0002Ew-Jd; Sat, 25 Jul 2026 12:36:06 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date:
 mime-version; bh=2ckrhpiwDHrB7XevWEvpsGOg9iep0jvve1rJ7/nvD9Q=; b=ScsjQkX+CmSd
 BwhL4O/UvDsKc8vMOt9HN/rcTncDIKzgGkpaEdtmJqSxMlf/+aoGQDr1qhSPNKHMeBACbnX7fgNYK
 ETadtAgNguL7OLqxwm3I2qEnH2ERevCSGRBr/6eC47uRmTjIge5Q9uLws4KVeD4OKioXA7ngbOYvK
 ICVZcLf6ZqiZbR5tuRvnLCvgQxB+swalO4hVjEK43C2yKW7cwjps83k7lwoU0ihAlIq/XGF1+GAdS
 1AGCcgJ3dYMIwlGq5aMrWyDtuVc1ZWVX+XAdgzj8bVu4LwrXDgRY2xwpp070omp5uj/0cQRlPlb+V
 zvaMPaePDEWb1u0FDxphyw==;
Date: Sat, 25 Jul 2026 19:36:01 +0300
Message-Id: <86ldazt4b2.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: "Drew Adams" <drew00000001@HIDDEN>
In-Reply-To: <002301dd1c51$67640600$362c1200$@gmail.com>
 (drew00000001@HIDDEN)
Subject: Re: bug#81492: 30.2;
 `tags-query-replace' signature doesn't match doc or byte-compiler
References: <002301dd1c51$67640600$362c1200$@gmail.com>
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 81492
Cc: 81492 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

tags 81492 notabug
thanks

> From: "Drew Adams" <drew00000001@HIDDEN>
> Date: Sat, 25 Jul 2026 09:19:43 -0700
> 
> The byte-compiler gives a warning for a call with 4 args - even for
> non-interactive use:
> 
>     'tags-query-replace' called with 4 arguments, but
>     accepts only 2 or 3
> 
> The doc was massaged to advertise only 2 or 3 args (from 27.1).
> 
> But the fourth arg is still supported, and there's not even any
> obsoletion or deprecation.
> 
> Why the byte-compiler warning?  Why isn't the fourth arg shown in the
> doc?

Because we don't want anyone to use the 4th argument.  That's why we
use advertised-calling-convention there.

I see no bug here, only the behavior we intend to have.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#81492; Package emacs. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 25 Jul 2026 16:19:58 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Jul 25 12:19:58 2026
Received: from localhost ([127.0.0.1]:52603 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1wnf6U-00012x-2K
	for submit <at> debbugs.gnu.org; Sat, 25 Jul 2026 12:19:58 -0400
Received: from lists1p.gnu.org ([2001:470:142::17]:57978)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <drew00000001@HIDDEN>)
 id 1wnf6Q-00011x-RW
 for submit <at> debbugs.gnu.org; Sat, 25 Jul 2026 12:19:56 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10])
 by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <drew00000001@HIDDEN>)
 id 1wnf6L-0002GO-C5
 for bug-gnu-emacs@HIDDEN; Sat, 25 Jul 2026 12:19:49 -0400
Received: from mail-pg1-x530.google.com ([2607:f8b0:4864:20::530])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <drew00000001@HIDDEN>)
 id 1wnf6J-0006jN-Q8
 for bug-gnu-emacs@HIDDEN; Sat, 25 Jul 2026 12:19:49 -0400
Received: by mail-pg1-x530.google.com with SMTP id
 41be03b00d2f7-cbb85186d43so721513a12.3
 for <bug-gnu-emacs@HIDDEN>; Sat, 25 Jul 2026 09:19:47 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=gmail.com; s=20251104; t=1784996386; x=1785601186; darn=gnu.org;
 h=content-language:thread-index:content-transfer-encoding
 :content-type:mime-version:message-id:date:subject:to:from:from:to
 :cc:subject:date:message-id:reply-to:content-type;
 bh=vWEBZglEbOyGxtEirDHJBB5owZe1rvygyVh6uHQs900=;
 b=UIVjHO6knCgk2peSzwb7N6r5zTgVzeDB02HjtvbgWdNluZDo/c3ouf7/c7/i5SnYi+
 Qcb5b/C6lEnA8c30AwKTtPcshLWjY7KTCU21o2LRKAlI7bihqH4+nLjHuDnXXyw6WuEM
 VIUFFXHSk5JVyoblVUMEDwLl5fOpb854wSoU+X7MUReNinN2WHySJCMzDitnzjomCviU
 cBm3yLLxW8uIVfu0jN+Gs0guzRqbUhl//cZddgykgWom+efIDLafjQBfNx6zToq0oTdY
 tVEinmbFMtPNgwggIEDFtjJax2O9P15vApBtcjq6SccvDLsUbJFwNPlR4/PixP/urwNL
 dDTA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20251104; t=1784996386; x=1785601186;
 h=content-language:thread-index:content-transfer-encoding
 :content-type:mime-version:message-id:date:subject:to:from:x-gm-gg
 :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to
 :content-type;
 bh=vWEBZglEbOyGxtEirDHJBB5owZe1rvygyVh6uHQs900=;
 b=DQX2Z6DuJ+zEkqNUwllQk5v7hLYMnAm52OwS54ox+kqjd96ZN59sALJgDxbPtzj1o3
 kw9S+xi71PjTi5M/X5H6sq+8EjWYIFrRqeUS63gPTXU5rmJceWF7P924Mm8y2nO+DORU
 V43zxcedpfp0LJGhqftpgZNBYt0SUG+Dz03CaQ++Ow9gDASNx44T0HJkfNBXQ5EpB2un
 CPMJwBN7ht9GZDzv33Kw311yWMpIIXJZZZkV1PMuzi2MsdSGGyH6WZFDp58AO6uIhvKH
 4V5mm2jH3pfZrb7o66+Q9YBZL+kdqi1cFw0gCFnLlLDEMFyNWwfjbidP8wtuAci6i0tG
 tTwQ==
X-Gm-Message-State: AOJu0Yx41oMgcJIa+obP3moSxWtxwww7hQ0BSPBWc6kl3enpSfAMzOwg
 +qMjJ++UY8MP3fTUj4JFwiK2r2t4nIJTePq69Yo7NJd0n9sBJ3cAAPDbIYF1uA==
X-Gm-Gg: AR+sD10fG0GWGkL8iL/i2yi985tf9yVQjIHwQDqiExMDLbK4H4mNu6VWmB9q9a92VCn
 QN7ZEbPxnd0aoKgcUzCHwHF7BtQs98Hr9HpuDJjBE8CwTiwqYqo5A/RgUV/XA/q19jWsvSuW6fY
 pgMXKz3PiwqfKrxM0rD8qG8HwsNMePhU+XlVLbLheJcystfevVMGnYeu7SCJyhau8OxBX6twiaU
 esB+jFAgdQWfQHRDgQPopQeBlXKTolwlJZAFyd5QNgKVyYG2WW3YSnH4ygxZ6vS8oHp2phEEz8X
 0qggihPxRbKXRFd4Qh1ugL7XQ6SJ91oB0y+O1E6T+8xPSFuwy++jZi7XHPQcMeX1rvmcbsef2Ck
 BIC9le2FqUAnVwCt27KwOaw9GpmkPtMgX8eNDf/u8asUwxXNijRbl20nB4B/iHyho0Nu7OSEUlY
 sbcPZ1ugnaYtE=
X-Received: by 2002:a17:90b:5387:b0:38e:5741:5173 with SMTP id
 98e67ed59e1d1-38f2965bc5fmr2864259a91.29.1784996385955; 
 Sat, 25 Jul 2026 09:19:45 -0700 (PDT)
Received: from Bufflehead ([2601:640:8d01:4270:2d37:7d63:31c7:464e])
 by smtp.gmail.com with ESMTPSA id
 a92af1059eb24-13d13003f12sm63551921c88.2.2026.07.25.09.19.45
 for <bug-gnu-emacs@HIDDEN>
 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128);
 Sat, 25 Jul 2026 09:19:45 -0700 (PDT)
From: "Drew Adams" <drew00000001@HIDDEN>
To: <bug-gnu-emacs@HIDDEN>
Subject: 30.2; `tags-query-replace' signature doesn't match doc or
 byte-compiler
Date: Sat, 25 Jul 2026 09:19:43 -0700
Message-ID: <002301dd1c51$67640600$362c1200$@gmail.com>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: 7bit
X-Mailer: Microsoft Outlook 16.0
Thread-Index: Ad0cUV+baHRvhW0+TeGlIegPjQGsrA==
Content-Language: en-us
Received-SPF: pass client-ip=2607:f8b0:4864:20::530;
 envelope-from=drew00000001@HIDDEN; helo=mail-pg1-x530.google.com
X-Spam_score_int: -17
X-Spam_score: -1.8
X-Spam_bar: -
X-Spam_report: (-1.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
 DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,
 FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001,
 RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 2.2 (++)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 the administrator of that system for details.
 Content preview:  The byte-compiler gives a warning for a call with 4 args -
 even for non-interactive use: 'tags-query-replace' called with 4 arguments,
 but accepts only 2 or 3 The doc was massaged to advertise only 2 or 3 args
 (from 27.1). 
 Content analysis details:   (2.2 points, 10.0 required)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 1.0 SPF_SOFTFAIL           SPF: sender does not match SPF record (softfail)
 0.0 FREEMAIL_FROM          Sender email is commonly abused enduser mail
 provider (drew00000001[at]gmail.com)
 -0.0 SPF_HELO_PASS          SPF: HELO matches SPF record
 1.0 FORGED_GMAIL_RCVD      'From' gmail.com does not match 'Received'
 headers
 0.2 FREEMAIL_ENVFROM_END_DIGIT Envelope-from freemail username ends
 in digit (drew00000001[at]gmail.com)
 -0.0 RCVD_IN_DNSWL_NONE     RBL: Sender listed at https://www.dnswl.org/,
 no trust [2001:470:142:0:0:0:0:17 listed in] [list.dnswl.org]
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 1.2 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 the administrator of that system for details.
 
 Content preview:  The byte-compiler gives a warning for a call with 4 args -
    even for non-interactive use: 'tags-query-replace' called with 4 arguments,
    but accepts only 2 or 3 The doc was massaged to advertise only 2 or 3 args
    (from 27.1). 
 
 Content analysis details:   (1.2 points, 10.0 required)
 
  pts rule name              description
 ---- ---------------------- --------------------------------------------------
 -0.0 RCVD_IN_DNSWL_NONE     RBL: Sender listed at https://www.dnswl.org/,
                              no trust
                             [2001:470:142:0:0:0:0:17 listed in]
                             [list.dnswl.org]
  1.0 SPF_SOFTFAIL           SPF: sender does not match SPF record (softfail)
  0.0 FREEMAIL_FROM          Sender email is commonly abused enduser mail
                             provider (drew00000001[at]gmail.com)
 -0.0 SPF_HELO_PASS          SPF: HELO matches SPF record
  1.0 FORGED_GMAIL_RCVD      'From' gmail.com does not match 'Received'
                             headers
  0.2 FREEMAIL_ENVFROM_END_DIGIT Envelope-from freemail username ends
                             in digit (drew00000001[at]gmail.com)
 -1.0 MAILING_LIST_MULTI     Multiple indicators imply a widely-seen list
                             manager

The byte-compiler gives a warning for a call with 4 args - even for
non-interactive use:

    'tags-query-replace' called with 4 arguments, but
    accepts only 2 or 3

The doc was massaged to advertise only 2 or 3 args (from 27.1).

But the fourth arg is still supported, and there's not even any
obsoletion or deprecation.

Why the byte-compiler warning?  Why isn't the fourth arg shown in the
doc?

All that's said is that for interactive use "this is superseded" bv
another command.  It's not clear what "superseded" is supposed to mean
here.

And why have a byte-compiler warning for such "superseded" use,
especially even when the function isn't used interactively?
Confusing, unclear.


In GNU Emacs 30.2 (build 2, x86_64-w64-mingw32) of 2025-08-14 built on
 AVALON
Windowing system distributor 'Microsoft Corp.', version 10.0.26200
System Description: Microsoft Windows 10 Home (v10.0.2009.26200.8875)

Configured using:
 'configure --with-modules --without-dbus --with-native-compilation=aot
 --without-compress-install --with-tree-sitter CFLAGS=-O2
 prefix=/g/rel/install-emacs-30.2'

Configured features:
ACL GIF GMP GNUTLS HARFBUZZ JPEG LCMS2 LIBXML2 MODULES NATIVE_COMP
NOTIFY W32NOTIFY PDUMPER PNG RSVG SOUND SQLITE3 THREADS TIFF
TOOLKIT_SCROLL_BARS TREE_SITTER WEBP XPM ZLIB

(NATIVE_COMP present but libgccjit not available)

Important settings:
  value of $LANG: ENU
  locale-coding-system: cp1252





Acknowledgement sent to "Drew Adams" <drew00000001@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#81492; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Sat, 25 Jul 2026 16:45:03 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.