From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#52821: Should "(elisp) Keymaps" describe key sequences first? Date: Mon, 27 Dec 2021 07:24:22 -0800 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="11601"; mail-complaints-to="usenet@ciao.gmane.io" To: 52821@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Dec 27 16:25:25 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1n1rsL-0002or-5P for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 27 Dec 2021 16:25:25 +0100 Original-Received: from localhost ([::1]:52172 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n1rsJ-0000hP-Gi for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 27 Dec 2021 10:25:23 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:44976) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n1rs0-0000fj-Ik for bug-gnu-emacs@gnu.org; Mon, 27 Dec 2021 10:25:04 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:60665) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n1rs0-0005G5-1c for bug-gnu-emacs@gnu.org; Mon, 27 Dec 2021 10:25:04 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1n1rry-0004Py-VB for bug-gnu-emacs@gnu.org; Mon, 27 Dec 2021 10:25:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 27 Dec 2021 15:25:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 52821 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.164061867116861 (code B ref -1); Mon, 27 Dec 2021 15:25:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 27 Dec 2021 15:24:31 +0000 Original-Received: from localhost ([127.0.0.1]:43965 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n1rrS-0004Ns-Ul for submit@debbugs.gnu.org; Mon, 27 Dec 2021 10:24:31 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:53572) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n1rrP-0004NW-0Y for submit@debbugs.gnu.org; Mon, 27 Dec 2021 10:24:27 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:44658) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n1rrO-0000WE-RT for bug-gnu-emacs@gnu.org; Mon, 27 Dec 2021 10:24:26 -0500 Original-Received: from mail-pg1-f179.google.com ([209.85.215.179]:45015) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n1rrL-000591-Qk for bug-gnu-emacs@gnu.org; Mon, 27 Dec 2021 10:24:26 -0500 Original-Received: by mail-pg1-f179.google.com with SMTP id m15so13742496pgu.11 for ; Mon, 27 Dec 2021 07:24:23 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:mime-version:date:message-id:subject:to; bh=BRAXARY3p/U97fjdLmxoUO5vhcbEvks/j+AjoNSxj7g=; b=lyff7rHn5Zt0cyaNQBZPrrcuw74fzZ+2HhcJZrAaUjp1zlrRVepFrYnqhX8CaUGJ+Z Dp9lLNWg82EPTsMCuBpLTaPynADC4rtvMw0Xq2mfk5FrqeLwm3olVAP9CUgl7I17+i9X 1n6EJ1tY04LKhiZGEHqH7bKUy8hRmwNa2oBrsdrnbhcgzPNkBeW+YQU8x/AWR3vD3HW0 D/LfjuZY72TGCJcmDbhgBiQ6YZ5VS/H88655zPpWugRTfTVImm+PZBE7M7QOWPjJzB9y 5EAEhfJCD51zNgc03gwhN00JRWy/WXFzc0eihOEJ+GOTItCTFEbBsAHNM4OJxJ4xJuV+ /sEw== X-Gm-Message-State: AOAM53105WSna2vDFXO1qt9HlNniG1N33ySkktdxAKNfd8A6N55yyty2 JtKEqOhAvSUd1uzsowCms0sLZV/hD+kV6MC9A471NZKP X-Google-Smtp-Source: ABdhPJxMND4ETzpXKJpSGvaMso7rqBeR8G23AUOw67NXUDhXMoiTrrEocus5S86m+ujElcWosfbKdfVXPhIbF+NAbXc= X-Received: by 2002:a63:4b42:: with SMTP id k2mr15796258pgl.591.1640618662528; Mon, 27 Dec 2021 07:24:22 -0800 (PST) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Mon, 27 Dec 2021 07:24:22 -0800 Received-SPF: pass client-ip=209.85.215.179; envelope-from=stefankangas@gmail.com; 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:223197 Archived-At: 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?