[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#60859: [PATCH] Remove reference to the kbd function from documentati
From: |
Panagiotis Koutsourakis |
Subject: |
bug#60859: [PATCH] Remove reference to the kbd function from documentation |
Date: |
Tue, 17 Jan 2023 21:40:28 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) |
On Tue, Jan 17 2023, Eli Zaretskii wrote:
>
> There's no need to generalize so much. Let's handle this specific
> issue, and then move on.
>
> For now, I don't want to remove references to 'kbd' from the manual,
> because many people still use it. So please accept that as the
> baseline, and let's find the best way to describe the new APIs as
> well.
Eli, I am not sure if you saw my earlier message with the second
proposed patch taking into account your feedback from yesterday.
Apologies for any confusion I caused.
Robert raised some valid points in his reply about it:
1. it does not describe accurately the arguments accepted by the old API:
lisp strings and vectors of input events are missing. I think that
pointing the users to the reference manual is enough to remedy this.
2. The syntax accepted by the new API and 'kbd' is not explicit. This
is, I believe, a more serious issue. I don't think that the previous
versions of the manual had an explicit description of it at this point,
but since we are re-examining the section anyway, we should write a few
words. I adapted the description Robert wrote in his e-mail (thank you
Robert!).
I am attaching the patch with these changes.
Panos.
0001-Reword-user-documentation-on-binding-keys-in-lisp.patch
Description: Text Data
- bug#60859: [PATCH] Remove reference to the kbd function from documentation, Panagiotis Koutsourakis, 2023/01/16
- bug#60859: [PATCH] Remove reference to the kbd function from documentation, Eli Zaretskii, 2023/01/16
- bug#60859: [PATCH] Remove reference to the kbd function from documentation, Panagiotis Koutsourakis, 2023/01/16
- bug#60859: [PATCH] Remove reference to the kbd function from documentation, Eli Zaretskii, 2023/01/16
- bug#60859: [PATCH] Remove reference to the kbd function from documentation, Panagiotis Koutsourakis, 2023/01/17
- bug#60859: [PATCH] Remove reference to the kbd function from documentation, Robert Pluim, 2023/01/17
- bug#60859: [PATCH] Remove reference to the kbd function from documentation, Panagiotis Koutsourakis, 2023/01/17
- bug#60859: [PATCH] Remove reference to the kbd function from documentation, Robert Pluim, 2023/01/17
- bug#60859: [PATCH] Remove reference to the kbd function from documentation, Eli Zaretskii, 2023/01/17
- bug#60859: [PATCH] Remove reference to the kbd function from documentation,
Panagiotis Koutsourakis <=
- bug#60859: [PATCH] Remove reference to the kbd function from documentation, Eli Zaretskii, 2023/01/21