GNU logs - #52821, boring messages

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#52821: Should "(elisp) Keymaps" describe key sequences first?
Resent-From: Stefan Kangas <stefan@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Mon, 27 Dec 2021 15:25:02 +0000
Resent-Message-ID: <handler.52821.B.164061867116861 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 52821 <at> debbugs.gnu.org
From: Stefan Kangas <stefan@HIDDEN>
MIME-Version: 1.0
Date: Mon, 27 Dec 2021 07:24:22 -0800
Message-ID: <CADwFkmmNG8TRpiphZPbadywnj4qXG2D6frtGO=ZU-hY3_FMzzg@HIDDEN>
Content-Type: text/plain; charset="UTF-8"
Received-SPF: pass client-ip=209.85.215.179;
 envelope-from=stefankangas@HIDDEN; helo=mail-pg1-f179.google.com
X-Spam_score_int: -13
X-Spam_score: -1.4
X-Spam_bar: -
X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9,
 FREEMAIL_FORGED_FROMDOMAIN=0.248, FREEMAIL_FROM=0.001,
 HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_DNSWL_NONE=-0.0001,
 RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=no autolearn_force=no
X-Spam_action: no action
X-Spam-Score: -0.8 (/)
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.8 (-)

Now that we promote the new keymap-* functions, does it really make
sense to start the section (info "(elisp) Keymaps") with a description
of key sequences?

This seems to now be considered more of an internal detail, and the
thing that should be exposed to (new) ELisp code is rather the new key
description format accepted by `key-valid-p'.

I'm thinking it should be moved further down, perhaps in a section next
to this one:

* Low-Level Key Binding::       Legacy key syntax description.

There is a good description on the "new" key format in
(info "(elisp) Changing Key Bindings").  Perhaps it should
be moved up instead?

Message sent:

Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
Content-Type: text/plain; charset=utf-8
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: Stefan Kangas <stefan@HIDDEN>
Subject: bug#52821: Acknowledgement (Should "(elisp) Keymaps" describe key
 sequences first?)
Message-ID: <handler.52821.B.164061867116861.ack <at> debbugs.gnu.org>
References: <CADwFkmmNG8TRpiphZPbadywnj4qXG2D6frtGO=ZU-hY3_FMzzg@HIDDEN>
X-Gnu-PR-Message: ack 52821
X-Gnu-PR-Package: emacs
Reply-To: 52821 <at> debbugs.gnu.org
Date: Mon, 27 Dec 2021 15:25:03 +0000

Thank you for filing a new bug report with debbugs.gnu.org.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 bug-gnu-emacs@HIDDEN

If you wish to submit further information on this problem, please
send it to 52821 <at> debbugs.gnu.org.

Please do not send mail to help-debbugs@HIDDEN unless you wish
to report a problem with the Bug-tracking system.

--=20
52821: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D52821
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#52821: Should "(elisp) Keymaps" describe key sequences first?
Resent-From: Richard Stallman <rms@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Tue, 28 Dec 2021 04:21:01 +0000
Resent-Message-ID: <handler.52821.B52821.164066524511235 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: Stefan Kangas <stefan@HIDDEN>
Cc: 52821 <at> debbugs.gnu.org
Reply-To: rms@HIDDEN
Content-Type: text/plain; charset=Utf-8
From: Richard Stallman <rms@HIDDEN>
In-Reply-To: <CADwFkmmNG8TRpiphZPbadywnj4qXG2D6frtGO=ZU-hY3_FMzzg@HIDDEN>
 (message from Stefan Kangas on Mon, 27 Dec 2021 07:24:22 -0800)
References: <CADwFkmmNG8TRpiphZPbadywnj4qXG2D6frtGO=ZU-hY3_FMzzg@HIDDEN>
Message-Id: <E1n23yT-0007OD-La@HIDDEN>
Date: Mon, 27 Dec 2021 23:20:33 -0500
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > Now that we promote the new keymap-* functions, does it really make
  > sense to start the section (info "(elisp) Keymaps") with a description
  > of key sequences?

  > This seems to now be considered more of an internal detail,

A key sequence is a Lisp object, and it's not internal -- quite a few
programs operate on them.

The description in that node is confused between describing the
Lisp object itself and describing its printed representation.
Perhaps this node should describe the Lisp object format
and the issue of printing and inputting them should be elsewhere.

-- 
Dr Richard Stallman (https://stallman.org)
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#52821: Should "(elisp) Keymaps" describe key sequences first?
Resent-From: Lars Ingebrigtsen <larsi@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Wed, 29 Dec 2021 16:03:01 +0000
Resent-Message-ID: <handler.52821.B52821.164079377221038 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: Stefan Kangas <stefan@HIDDEN>
Cc: 52821 <at> debbugs.gnu.org
From: Lars Ingebrigtsen <larsi@HIDDEN>
References: <CADwFkmmNG8TRpiphZPbadywnj4qXG2D6frtGO=ZU-hY3_FMzzg@HIDDEN>
Date: Wed, 29 Dec 2021 17:02:32 +0100
In-Reply-To: <CADwFkmmNG8TRpiphZPbadywnj4qXG2D6frtGO=ZU-hY3_FMzzg@HIDDEN>
 (Stefan Kangas's message of "Mon, 27 Dec 2021 07:24:22 -0800")
Message-ID: <875yr75rhj.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

Stefan Kangas <stefan@HIDDEN> writes:

> Now that we promote the new keymap-* functions, does it really make
> sense to start the section (info "(elisp) Keymaps") with a description
> of key sequences?
>
> This seems to now be considered more of an internal detail, and the
> thing that should be exposed to (new) ELisp code is rather the new key
> description format accepted by `key-valid-p'.
>
> I'm thinking it should be moved further down, perhaps in a section next
> to this one:
>
> * Low-Level Key Binding::       Legacy key syntax description.

Yes, sounds good to me.

> There is a good description on the "new" key format in
> (info "(elisp) Changing Key Bindings").  Perhaps it should
> be moved up instead?

Yup.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Last modified: Wed, 29 Dec 2021 16:15:02 UTC

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