From unknown Fri Aug 15 19:33:57 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34263: 26.1; documentation for kmacro-insert-counter C-u is wrong Resent-From: Allen Li Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 31 Jan 2019 09:56:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 34263 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 34263@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.154892850316370 (code B ref -1); Thu, 31 Jan 2019 09:56:02 +0000 Received: (at submit) by debbugs.gnu.org; 31 Jan 2019 09:55:03 +0000 Received: from localhost ([127.0.0.1]:52174 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gp93n-0004Fx-F3 for submit@debbugs.gnu.org; Thu, 31 Jan 2019 04:55:03 -0500 Received: from eggs.gnu.org ([209.51.188.92]:51165) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gp93m-0004FR-4q for submit@debbugs.gnu.org; Thu, 31 Jan 2019 04:55:02 -0500 Received: from lists.gnu.org ([209.51.188.17]:48054) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gp93g-0001zb-RW for submit@debbugs.gnu.org; Thu, 31 Jan 2019 04:54:56 -0500 Received: from eggs.gnu.org ([209.51.188.92]:37265) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gp93e-00068H-5N for bug-gnu-emacs@gnu.org; Thu, 31 Jan 2019 04:54:56 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gp93d-0001vL-6F for bug-gnu-emacs@gnu.org; Thu, 31 Jan 2019 04:54:54 -0500 Received: from mail-io1-xd34.google.com ([2607:f8b0:4864:20::d34]:42371) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gp93c-0001hf-Pc for bug-gnu-emacs@gnu.org; Thu, 31 Jan 2019 04:54:53 -0500 Received: by mail-io1-xd34.google.com with SMTP id x6so2097235ioa.9 for ; Thu, 31 Jan 2019 01:54:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=felesatra-moe.20150623.gappssmtp.com; s=20150623; h=mime-version:from:date:message-id:subject:to; bh=Rx0t226jVw4EqnY13fZYkpPj6k6k4kYNphidk8hOrO0=; b=XOGG5KLT173eIuiMhr1fNTdcoojwp5uBVHYdcZ/Df42OoGcUu6v+JURQVwCaAfJ33l +xo3F2QO44YlJFCEVwH8+9A8SsO6nUdEtAMu89N1QV54a7zN/MWrsGrrpoS/wKWpWlGk O7363W10ofLe3BYHvOcOX585D58RL6Q6lgJnLA/q+jXCnJ5RMHwS+62su0jGuAa5ibkW sEObOq3qRN9SRBP4knK64FGCtQZ5C18ByVu/xm1NTqWeltpNQsQECA5FqLHv/tjD2rGd XVbe9pDIszFUeZTAcPozo8q4VjGjGqiI9JmlIVSi4YTfDLRcpn4xbo97pX9JkN88Ko95 XGPw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=Rx0t226jVw4EqnY13fZYkpPj6k6k4kYNphidk8hOrO0=; b=A68KLwSw1HYQk3IInT4KLIi9WYsrfUd0ldgpF+7op9njGRTILdaU6PqgSpOF2lSKNJ sJ1jtv4DGvuyb8fwHcFnlV62bZ4PfL5SR09y1v5JqbePi7l97ZSKe1OoR9SRGZEbwcZ9 6/jk4/ycVVMDVlagg/ZjGIas5nA/2kc+NtG0yOKtyZdql/QoAfRnzCBS1CGDPHP4INc/ UpSIF6CosNJBL8peH4Dw7LzdYdda5KhIKvgvdRwbpXxF+AJuoFTwJEF3XGqDAE4mZfbW Fs1+jmPOX684JdfzZJOOBDejGBvCHWI4N0PEqgIvIHhg7CcvZfDJJgsfamvlynEL+l0d B25Q== X-Gm-Message-State: AHQUAuZ10wqC7PylJdiImwQ7ugUJbT0byL0iYeYGU4KQJmoIY4+H8Tmf 2EWhPStfzA30fOw0rVtKTxHrOralvo9cAP5/5SpWfnv6N28= X-Google-Smtp-Source: AHgI3IarhVlRY3Ga3SQOQpE0QMase2mK545qweNECs2ND/vXWgnvLTqBZER92Kuq3QfSLImR8JSWCMhXeKRx78iCTkM= X-Received: by 2002:a6b:2b95:: with SMTP id r143mr5254686ior.217.1548928478983; Thu, 31 Jan 2019 01:54:38 -0800 (PST) MIME-Version: 1.0 From: Allen Li Date: Thu, 31 Jan 2019 09:54:28 +0000 Message-ID: Content-Type: text/plain; charset="UTF-8" X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:4864:20::d34 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Spam-Score: 1.0 (+) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) The documentation for the behavior of C-u argument to kmacro-insert-counter is wrong everywhere (both in the docstring and manual, and also for kmacro-start-macro-or-insert-counter). It says that supplying C-u is the same as supplying C-u 0. This is completely wrong, and has caused confusion for multiple users (I can dig up some links if desired). C-u 0 inserts the current value of the kmacro counter without incrementing it. C-u inserts the *previous* value of the kmacro counter, which is usually one less than the current value. From unknown Fri Aug 15 19:33:57 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34263: 26.1; documentation for kmacro-insert-counter C-u is wrong Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 31 Jan 2019 15:22:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34263 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Allen Li Cc: 34263@debbugs.gnu.org Received: via spool by 34263-submit@debbugs.gnu.org id=B34263.154894809314448 (code B ref 34263); Thu, 31 Jan 2019 15:22:01 +0000 Received: (at 34263) by debbugs.gnu.org; 31 Jan 2019 15:21:33 +0000 Received: from localhost ([127.0.0.1]:53148 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gpE9k-0003kx-VM for submit@debbugs.gnu.org; Thu, 31 Jan 2019 10:21:33 -0500 Received: from eggs.gnu.org ([209.51.188.92]:33982) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gpE9i-0003kf-TZ for 34263@debbugs.gnu.org; Thu, 31 Jan 2019 10:21:31 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]:33625) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gpE9a-0008Ng-UE; Thu, 31 Jan 2019 10:21:24 -0500 Received: from [176.228.60.248] (port=3419 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1gpE9X-00014t-6Y; Thu, 31 Jan 2019 10:21:21 -0500 Date: Thu, 31 Jan 2019 17:21:13 +0200 Message-Id: <83o97wzwd2.fsf@gnu.org> From: Eli Zaretskii In-reply-to: (message from Allen Li on Thu, 31 Jan 2019 09:54:28 +0000) References: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) > From: Allen Li > Date: Thu, 31 Jan 2019 09:54:28 +0000 > > The documentation for the behavior of C-u argument to > kmacro-insert-counter is wrong everywhere (both in the docstring and > manual, and also for kmacro-start-macro-or-insert-counter). Isn't this the same issue as the one you raised in bug#31243? Which is already solved in the Git repository for Emacs 26.2? > It says that supplying C-u is the same as supplying C-u 0. This is > completely wrong, and has caused confusion for multiple users (I can > dig up some links if desired). C-u 0 inserts the current value of the > kmacro counter without incrementing it. C-u inserts the *previous* > value of the kmacro counter, which is usually one less than the > current value. Please look at the documentation on the emacs-26 branch and tell what exactly is wrong/unclear/confusing there. Thanks. From unknown Fri Aug 15 19:33:57 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34263: 26.1; documentation for kmacro-insert-counter C-u is wrong Resent-From: Allen Li Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 31 Jan 2019 21:42:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34263 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 34263@debbugs.gnu.org Received: via spool by 34263-submit@debbugs.gnu.org id=B34263.15489709202434 (code B ref 34263); Thu, 31 Jan 2019 21:42:01 +0000 Received: (at 34263) by debbugs.gnu.org; 31 Jan 2019 21:42:00 +0000 Received: from localhost ([127.0.0.1]:53454 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gpK5w-0000dC-BC for submit@debbugs.gnu.org; Thu, 31 Jan 2019 16:42:00 -0500 Received: from mail-io1-f47.google.com ([209.85.166.47]:42991) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gpK5t-0000cz-UQ for 34263@debbugs.gnu.org; Thu, 31 Jan 2019 16:41:58 -0500 Received: by mail-io1-f47.google.com with SMTP id x6so4000425ioa.9 for <34263@debbugs.gnu.org>; Thu, 31 Jan 2019 13:41:57 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=felesatra-moe.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=zpOkQgYtpt6Xb7+m0CArT+tLfgB/ttVDGVcdOc1x4ak=; b=xfcilAdoXZs7lXQhemSbv0BGXNYGTHwpiZJ6TD2mROa1lCW1VGRABOwXrijCJxBUNF TjYP0qtRCVtzBoIh910L1jnlRzsWWNmlpl0tDW2DxmUiNM2ZgePq5A4yU15x/62C+mVE h7e5pi+V9Vkda7ulKkCWkj0j/x7zT4sBcjAnnDrQvLmmMcoWqVbTnDBltHIj5XV3wLNY fR7dAZfDae2xq8NXJTlQWR4fjPMS2bvV9melbxsJn2nx1IIesZrHqHTMEm4+bGgSp1bt w89evrlSuXih8SfObHaM2ewnY2lxTSClvU/kDbZKGAU92/+sfyoXeOZFzZEC6/DblSBu navA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=zpOkQgYtpt6Xb7+m0CArT+tLfgB/ttVDGVcdOc1x4ak=; b=jjKTqNtux9x1yy9ZnmTOnkiwBKhfkGAikJGUesVpwvIo/zTgCrgSF0KYkvd15eNeeA fm4GKJ2xh2eTFdlmzHFCQEjI9/FZ5Yt7pP4/+jEApjMy6Eh6lLk9xg2LiYOfn1CCCPdY MvvifTvNdBORnEGxVg/MqBboPRF2Aj7V48hZpbeH4M+ZKKcCJ654Ikfvq9rTJV7fNlvk DBNtkwoUt/YlaNAEvNA2HDSaW6YfDv35b3L7YzM9aLgspGUr+EcaBO3q+W0fRshCysXP EsPS4MkGm1njWi3X+TKJbHU5U6KMs7rFlPhS0EJ75RfxZH2tcDgLB2UQ42f/7dhOaSyz V3fw== X-Gm-Message-State: AHQUAuZomNpNqJ8emDQrSjQ3yRawCNXg0gQsueVveI3fp7W5IPRVUQ4M ymDWkzxU4MZXgj/zj4dNq+KYwiDcCMElzqsBn8yxKA== X-Google-Smtp-Source: AHgI3IYv6nQpsAOAWQ1VncqbwxPuLnMUj1S0yzp051TAD1KjrVgUhU+Sj4N7moL1qImb7E3NZ1iZxeT+VBVfvJArXOc= X-Received: by 2002:a6b:2b95:: with SMTP id r143mr6854382ior.217.1548970912048; Thu, 31 Jan 2019 13:41:52 -0800 (PST) MIME-Version: 1.0 References: <83o97wzwd2.fsf@gnu.org> In-Reply-To: <83o97wzwd2.fsf@gnu.org> From: Allen Li Date: Thu, 31 Jan 2019 13:41:41 -0800 Message-ID: Content-Type: text/plain; charset="UTF-8" X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) On Thu, Jan 31, 2019 at 7:21 AM Eli Zaretskii wrote: > > > From: Allen Li > > Date: Thu, 31 Jan 2019 09:54:28 +0000 > > > > The documentation for the behavior of C-u argument to > > kmacro-insert-counter is wrong everywhere (both in the docstring and > > manual, and also for kmacro-start-macro-or-insert-counter). > > Isn't this the same issue as the one you raised in bug#31243? Which > is already solved in the Git repository for Emacs 26.2? > > > It says that supplying C-u is the same as supplying C-u 0. This is > > completely wrong, and has caused confusion for multiple users (I can > > dig up some links if desired). C-u 0 inserts the current value of the > > kmacro counter without incrementing it. C-u inserts the *previous* > > value of the kmacro counter, which is usually one less than the > > current value. > > Please look at the documentation on the emacs-26 branch and tell what > exactly is wrong/unclear/confusing there. On both the master branch and emacs-26: (defun kmacro-insert-counter (arg) "Insert current value of `kmacro-counter', then increment it by ARG. Interactively, ARG defaults to 1. With \\[universal-argument], insert current value of `kmacro-counter', but do not increment it." This is still wrong, C-u inserts the *previous* value of kmacro-counter. (defun kmacro-start-macro-or-insert-counter (arg) "Record subsequent keyboard input, defining a keyboard macro. The commands are recorded even as they are executed. Initializes the macro's `kmacro-counter' to ARG (or 0 if no prefix arg) before defining the macro. With \\[universal-argument], appends to current keyboard macro (keeping the current value of `kmacro-counter'). When used during defining/executing a macro, inserts the current value of `kmacro-counter' and increments the counter value by ARG (or by 1 if no prefix argument). With just \\[universal-argument], inserts the current value of `kmacro-counter', but does not modify the counter; this is the same as incrementing the counter by zero. This is still wrong. C-u is NOT the same as incrementing the counter by zero. C-u 0 inserts the *current* value of the counter, C-u inserts the *previous* value of the counter. @findex kmacro-insert-counter @kindex C-x C-k C-i When you are defining a keyboard macro, the command @key{F3} (@code{kmacro-start-macro-or-insert-counter}) inserts the current value of the keyboard macro's counter into the buffer, and increments the counter by 1. (If you are not defining a macro, @key{F3} begins a macro definition instead. @xref{Basic Keyboard Macro}.) You can use a numeric prefix argument to specify a different increment. If you just specify a @kbd{C-u} prefix, that is the same as an increment of zero: it inserts the current counter value without changing it. This is still wrong. C-u is NOT the same as incrementing the counter by zero. C-u 0 inserts the *current* value of the counter, C-u inserts the *previous* value of the counter. > > Thanks. From unknown Fri Aug 15 19:33:57 2025 X-Loop: help-debbugs@gnu.org Subject: bug#34263: 26.1; documentation for kmacro-insert-counter C-u is wrong Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 01 Feb 2019 10:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34263 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Allen Li Cc: 34263@debbugs.gnu.org Received: via spool by 34263-submit@debbugs.gnu.org id=B34263.154901522226054 (code B ref 34263); Fri, 01 Feb 2019 10:01:02 +0000 Received: (at 34263) by debbugs.gnu.org; 1 Feb 2019 10:00:22 +0000 Received: from localhost ([127.0.0.1]:53750 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gpVcT-0006m9-Rv for submit@debbugs.gnu.org; Fri, 01 Feb 2019 05:00:22 -0500 Received: from eggs.gnu.org ([209.51.188.92]:43703) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gpVcR-0006lw-RT for 34263@debbugs.gnu.org; Fri, 01 Feb 2019 05:00:20 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]:55861) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gpVcM-0008A7-Dx; Fri, 01 Feb 2019 05:00:14 -0500 Received: from [176.228.60.248] (port=4822 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1gpVcM-0005aZ-0c; Fri, 01 Feb 2019 05:00:14 -0500 Date: Fri, 01 Feb 2019 12:00:09 +0200 Message-Id: <83sgx7ygk6.fsf@gnu.org> From: Eli Zaretskii In-reply-to: (message from Allen Li on Thu, 31 Jan 2019 13:41:41 -0800) References: <83o97wzwd2.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) > From: Allen Li > Date: Thu, 31 Jan 2019 13:41:41 -0800 > Cc: 34263@debbugs.gnu.org > > On Thu, Jan 31, 2019 at 7:21 AM Eli Zaretskii wrote: > > > > > From: Allen Li > > > Date: Thu, 31 Jan 2019 09:54:28 +0000 > > > > > > The documentation for the behavior of C-u argument to > > > kmacro-insert-counter is wrong everywhere (both in the docstring and > > > manual, and also for kmacro-start-macro-or-insert-counter). > > > > Isn't this the same issue as the one you raised in bug#31243? Which > > is already solved in the Git repository for Emacs 26.2? > > > > > It says that supplying C-u is the same as supplying C-u 0. This is > > > completely wrong, and has caused confusion for multiple users (I can > > > dig up some links if desired). C-u 0 inserts the current value of the > > > kmacro counter without incrementing it. C-u inserts the *previous* > > > value of the kmacro counter, which is usually one less than the > > > current value. > > > > Please look at the documentation on the emacs-26 branch and tell what > > exactly is wrong/unclear/confusing there. > > On both the master branch and emacs-26: > > (defun kmacro-insert-counter (arg) > "Insert current value of `kmacro-counter', then increment it by ARG. > Interactively, ARG defaults to 1. With \\[universal-argument], insert > current value of `kmacro-counter', but do not increment it." > > This is still wrong, C-u inserts the *previous* value of kmacro-counter. How do you suggest to define "previous" to avoid the confusion? That was the reason for bug#31243. We must add to the documentation the definition of "previous" that would be clear and unequivocal. Thanks. From unknown Fri Aug 15 19:33:57 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Allen Li Subject: bug#34263: closed (Re: bug#34263: 26.1; documentation for kmacro-insert-counter C-u is wrong) Message-ID: References: <83a7jfy0z3.fsf@gnu.org> X-Gnu-PR-Message: they-closed 34263 X-Gnu-PR-Package: emacs Reply-To: 34263@debbugs.gnu.org Date: Fri, 01 Feb 2019 15:38:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1549035482-11179-1" This is a multi-part message in MIME format... ------------=_1549035482-11179-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #34263: 26.1; documentation for kmacro-insert-counter C-u is wrong which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 34263@debbugs.gnu.org. --=20 34263: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D34263 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1549035482-11179-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 34263-done) by debbugs.gnu.org; 1 Feb 2019 15:37:11 +0000 Received: from localhost ([127.0.0.1]:55145 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gpasR-0002tD-H3 for submit@debbugs.gnu.org; Fri, 01 Feb 2019 10:37:11 -0500 Received: from eggs.gnu.org ([209.51.188.92]:37373) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gpasP-0002sz-8q for 34263-done@debbugs.gnu.org; Fri, 01 Feb 2019 10:37:09 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]:44276) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gpasG-0005tX-OJ; Fri, 01 Feb 2019 10:37:03 -0500 Received: from [176.228.60.248] (port=1918 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1gpasF-0001R9-Vl; Fri, 01 Feb 2019 10:37:00 -0500 Date: Fri, 01 Feb 2019 17:36:48 +0200 Message-Id: <83a7jfy0z3.fsf@gnu.org> From: Eli Zaretskii To: darkfeline@felesatra.moe In-reply-to: <83sgx7ygk6.fsf@gnu.org> (message from Eli Zaretskii on Fri, 01 Feb 2019 12:00:09 +0200) Subject: Re: bug#34263: 26.1; documentation for kmacro-insert-counter C-u is wrong References: <83o97wzwd2.fsf@gnu.org> <83sgx7ygk6.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 34263-done Cc: 34263-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) > Date: Fri, 01 Feb 2019 12:00:09 +0200 > From: Eli Zaretskii > Cc: 34263@debbugs.gnu.org > > How do you suggest to define "previous" to avoid the confusion? That > was the reason for bug#31243. We must add to the documentation the > definition of "previous" that would be clear and unequivocal. Never mind, I think I found a good way of explaining what is the "previous" counter value, and fixed the docs accordingly. Take a look at the emacs-26 branch. Thanks. ------------=_1549035482-11179-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 31 Jan 2019 09:55:03 +0000 Received: from localhost ([127.0.0.1]:52174 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gp93n-0004Fx-F3 for submit@debbugs.gnu.org; Thu, 31 Jan 2019 04:55:03 -0500 Received: from eggs.gnu.org ([209.51.188.92]:51165) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gp93m-0004FR-4q for submit@debbugs.gnu.org; Thu, 31 Jan 2019 04:55:02 -0500 Received: from lists.gnu.org ([209.51.188.17]:48054) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gp93g-0001zb-RW for submit@debbugs.gnu.org; Thu, 31 Jan 2019 04:54:56 -0500 Received: from eggs.gnu.org ([209.51.188.92]:37265) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gp93e-00068H-5N for bug-gnu-emacs@gnu.org; Thu, 31 Jan 2019 04:54:56 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gp93d-0001vL-6F for bug-gnu-emacs@gnu.org; Thu, 31 Jan 2019 04:54:54 -0500 Received: from mail-io1-xd34.google.com ([2607:f8b0:4864:20::d34]:42371) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gp93c-0001hf-Pc for bug-gnu-emacs@gnu.org; Thu, 31 Jan 2019 04:54:53 -0500 Received: by mail-io1-xd34.google.com with SMTP id x6so2097235ioa.9 for ; Thu, 31 Jan 2019 01:54:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=felesatra-moe.20150623.gappssmtp.com; s=20150623; h=mime-version:from:date:message-id:subject:to; bh=Rx0t226jVw4EqnY13fZYkpPj6k6k4kYNphidk8hOrO0=; b=XOGG5KLT173eIuiMhr1fNTdcoojwp5uBVHYdcZ/Df42OoGcUu6v+JURQVwCaAfJ33l +xo3F2QO44YlJFCEVwH8+9A8SsO6nUdEtAMu89N1QV54a7zN/MWrsGrrpoS/wKWpWlGk O7363W10ofLe3BYHvOcOX585D58RL6Q6lgJnLA/q+jXCnJ5RMHwS+62su0jGuAa5ibkW sEObOq3qRN9SRBP4knK64FGCtQZ5C18ByVu/xm1NTqWeltpNQsQECA5FqLHv/tjD2rGd XVbe9pDIszFUeZTAcPozo8q4VjGjGqiI9JmlIVSi4YTfDLRcpn4xbo97pX9JkN88Ko95 XGPw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=Rx0t226jVw4EqnY13fZYkpPj6k6k4kYNphidk8hOrO0=; b=A68KLwSw1HYQk3IInT4KLIi9WYsrfUd0ldgpF+7op9njGRTILdaU6PqgSpOF2lSKNJ sJ1jtv4DGvuyb8fwHcFnlV62bZ4PfL5SR09y1v5JqbePi7l97ZSKe1OoR9SRGZEbwcZ9 6/jk4/ycVVMDVlagg/ZjGIas5nA/2kc+NtG0yOKtyZdql/QoAfRnzCBS1CGDPHP4INc/ UpSIF6CosNJBL8peH4Dw7LzdYdda5KhIKvgvdRwbpXxF+AJuoFTwJEF3XGqDAE4mZfbW Fs1+jmPOX684JdfzZJOOBDejGBvCHWI4N0PEqgIvIHhg7CcvZfDJJgsfamvlynEL+l0d B25Q== X-Gm-Message-State: AHQUAuZ10wqC7PylJdiImwQ7ugUJbT0byL0iYeYGU4KQJmoIY4+H8Tmf 2EWhPStfzA30fOw0rVtKTxHrOralvo9cAP5/5SpWfnv6N28= X-Google-Smtp-Source: AHgI3IarhVlRY3Ga3SQOQpE0QMase2mK545qweNECs2ND/vXWgnvLTqBZER92Kuq3QfSLImR8JSWCMhXeKRx78iCTkM= X-Received: by 2002:a6b:2b95:: with SMTP id r143mr5254686ior.217.1548928478983; Thu, 31 Jan 2019 01:54:38 -0800 (PST) MIME-Version: 1.0 From: Allen Li Date: Thu, 31 Jan 2019 09:54:28 +0000 Message-ID: Subject: 26.1; documentation for kmacro-insert-counter C-u is wrong To: bug-gnu-emacs@gnu.org Content-Type: text/plain; charset="UTF-8" X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:4864:20::d34 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) The documentation for the behavior of C-u argument to kmacro-insert-counter is wrong everywhere (both in the docstring and manual, and also for kmacro-start-macro-or-insert-counter). It says that supplying C-u is the same as supplying C-u 0. This is completely wrong, and has caused confusion for multiple users (I can dig up some links if desired). C-u 0 inserts the current value of the kmacro counter without incrementing it. C-u inserts the *previous* value of the kmacro counter, which is usually one less than the current value. ------------=_1549035482-11179-1--