--- Begin Message ---
Subject: |
26.1; documentation for kmacro-insert-counter C-u is wrong |
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).
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.
--- End Message ---
--- Begin Message ---
Subject: |
Re: bug#34263: 26.1; documentation for kmacro-insert-counter C-u is wrong |
Date: |
Fri, 01 Feb 2019 17:36:48 +0200 |
> Date: Fri, 01 Feb 2019 12:00:09 +0200
> From: Eli Zaretskii <address@hidden>
> Cc: address@hidden
>
> 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.
--- End Message ---