From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id 6AVkEhDgVGTIfQAASxT56A (envelope-from ) for ; Fri, 05 May 2023 12:53:04 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id GKczEhDgVGQHZAEA9RJhRA (envelope-from ) for ; Fri, 05 May 2023 12:53:04 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 956CF21C9 for ; Fri, 5 May 2023 12:53:03 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1put2l-0005Zr-RL; Fri, 05 May 2023 06:52:07 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1put2k-0005ZZ-4D for emacs-orgmode@gnu.org; Fri, 05 May 2023 06:52:06 -0400 Received: from mail-ej1-x630.google.com ([2a00:1450:4864:20::630]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1put2i-0000l4-D4 for emacs-orgmode@gnu.org; Fri, 05 May 2023 06:52:05 -0400 Received: by mail-ej1-x630.google.com with SMTP id a640c23a62f3a-965e93f915aso65518066b.2 for ; Fri, 05 May 2023 03:52:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1683283921; x=1685875921; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=jwoSk5xu6ftEwNr80dhPBRsAoZLboPhQW+Lxd4nH+kg=; b=a6TPIbb8qwhpKQMPBRXVfOLoxXWKvjGG6e5dAik4qs45PGUR7F6JCKL4YBgovfU1hL R+Hgise8/F6D38vPGV4x2zLclmEqlBYeKl1ywuNty5irmLhNn3U0CvbxHyGJLMXkM6W0 Y6qlG1cutvxlJGW3L+rGLN/qdavBfPbH3S7rkc5KocNwx2O7S3fiKpA9Prf3lxwyHeas WUSQC58zFdACD55hEoJ+mFKBGM1PZnpriASjqheeBDISJu6uT97mf7tbI1B7lSMHHO9o hMoDp0niirpnGjPxxiHglV3ijirENLqgOiGNPh+VUTIjRmBIVgWsufNlsgr0f6lOzCwY QpYQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1683283921; x=1685875921; h=to:subject:message-id:date:from:mime-version:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=jwoSk5xu6ftEwNr80dhPBRsAoZLboPhQW+Lxd4nH+kg=; b=P9L/mh5RVR1KjKS7Zb+HzpqU6sqcUHsFYrsy/evi0xethn1PT3t3u5GUbodnSPDD+X h5g30AQmkTaGgOc3RTwq1x3vJfeiUX1FRb9FqtFkHByZLi4oGgzlh+JH1W1epw2dDttZ zNDzQRR857WPsynVszvUHQQTg8zwWU/pxgyvsOQXLjoFgZ2aA0lPOyaLnKELJXPaMz3O 2wYGa2AyvLGRlHoHxM3e4lk5LU6UjZk602N5geEqhNe8Hv6xVJtXVFz/ukcBbtzxz3JD ZsAx1IqQax1PEVw2xjnJcKfIvlJureW6Z15jg+Ke66URfJPxJ2ZKKg7+TOgXfV4idQnQ 7vUA== X-Gm-Message-State: AC+VfDxsRK+LMRVsE0KflbXb709MW/Rfa0zmuP1BDEL95N5PttSMYLQc 6hKFTPy/Vwcbgs7rUhfGmAXui8BHWtUuW7jfFU9Nvd0LVyA= X-Google-Smtp-Source: ACHHUZ6nYOCrg+OwajYoX+dj20F+THmTOtug/sT0khfsmnhf6ZlpbFUigjMMa/FpaRUT7Ic0NGG+VMJNj/TUCXFF+dE= X-Received: by 2002:a17:907:7b8f:b0:965:9bf4:9009 with SMTP id ne15-20020a1709077b8f00b009659bf49009mr1032580ejc.26.1683283920815; Fri, 05 May 2023 03:52:00 -0700 (PDT) MIME-Version: 1.0 From: Yuval Langer Date: Fri, 5 May 2023 13:51:24 +0300 Message-ID: Subject: Suggestion: for each listed keybinding, also name the command To: emacs-orgmode@gnu.org Content-Type: multipart/mixed; boundary="0000000000002834bc05faf014b6" Received-SPF: pass client-ip=2a00:1450:4864:20::630; envelope-from=yuval.langer@gmail.com; helo=mail-ej1-x630.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Seal: i=1; s=key1; d=yhetil.org; t=1683283984; a=rsa-sha256; cv=none; b=pK+Ca8WFFtvqNXK3wZYCyM3d5FMTYehqxVKYEtYiFdPL2jInKofJeDy/ve3B5uPAVFFavh Nm2RfV6Ecfv/lSxi4njM+NyADjG6m7p71zmnTxxAtxwaGA6a2ZZi6CbvjR1v1eU4KLfaSh xro8KT6vCJbGsrWIwPVKr/JJuYRWMd4p00rTzIYM18EIWILCJAG5qm008dDkiNFkdRJBGs dmiop6n6lLcx8LCdT8lgUFaPWfD+3ZuzheRAgAhKvMHWKTD7D7hdzguNehJqFWJms/qRLC 48z2zBv9S2Iw2w+5afIw8irGac/ecBT9o89QASGY63IBOgM5s/tLOuw3C/A41A== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=a6TPIbb8; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1683283984; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=jwoSk5xu6ftEwNr80dhPBRsAoZLboPhQW+Lxd4nH+kg=; b=hR/h/JeYpBHSpyYH994Yco0q4qMH5QEE+UnGwoputiLWDhhc26V4qYUW4Nj2lwB5OuXO/+ ovLv9d3RuqEwoRRnSyiJUs3ezNyhIWHCTIaYOQcG/3xMjSpH2MQ3zSWKuZexOO6j+wQl3c C1M8dg29Pg/ys9yF8l2e9yirvs4a7WBU90UNgBPoNCNpgw7bH13hRqcLzofusQJmW0OIP4 IJyeZU5fC2G34OtgGZPxkn1Eru0ghJtbgXvkN/ynmTMrzbOPqzyXmnbmku+7CiYbsDEm1d LLCvNJhokOBnA+ndlEZOu5GsRgNDvVmlg5ZUeRDL7H1t345MThKCDg/uGmXtgw== X-Migadu-Scanner: scn1.migadu.com Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20221208 header.b=a6TPIbb8; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.80 X-Spam-Score: -3.80 X-Migadu-Queue-Id: 956CF21C9 X-TUID: d3qrAcVlwnrH --0000000000002834bc05faf014b6 Content-Type: text/plain; charset="UTF-8" For many commands, I find it helpful to first learn their names before learning their keybindings. The org-mode guide does not include command names. I want to add command names into the org-mode guide. I have attached an example of such an addition. The changes in the first commit might be later dropped as it might be better to add command names only in the command lists. This addition might not be appropriate for the org-mode guide, as it is already covered by the org-mode manual, but I would have found it very useful if the names of the commands were included. --0000000000002834bc05faf014b6 Content-Type: text/x-patch; charset="US-ASCII"; name="0001-Add-first-function-names.patch" Content-Disposition: attachment; filename="0001-Add-first-function-names.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_lhafdib20 RnJvbSBjMDNkODIxYTk3MjZlMjAzMTEzZDYyMmQxNTgxYTAyZDMyYjc1MzAyIE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBZdXZhbCBMYW5nZXIgPHl1dmFsbGFuZ2Vyb250aGVyb2FkQHBy b3Rvbi5tZT4KRGF0ZTogRnJpLCA1IE1heSAyMDIzIDExOjU3OjM3ICswMzAwClN1YmplY3Q6IFtQ QVRDSCAxLzJdIEFkZCBmaXJzdCBmdW5jdGlvbiBuYW1lcy4KCi0tLQogZG9jL29yZy1ndWlkZS5v cmcgfCAzICsrLQogMSBmaWxlIGNoYW5nZWQsIDIgaW5zZXJ0aW9ucygrKSwgMSBkZWxldGlvbigt KQoKZGlmZiAtLWdpdCBhL2RvYy9vcmctZ3VpZGUub3JnIGIvZG9jL29yZy1ndWlkZS5vcmcKaW5k ZXggOTU4MjhlNGMwLi4zNTgxZTBhNWUgMTAwNjQ0Ci0tLSBhL2RvYy9vcmctZ3VpZGUub3JnCisr KyBiL2RvYy9vcmctZ3VpZGUub3JnCkBAIC0xNDEsNyArMTQxLDggQEAgU2VlIFtbKk1pc2NlbGxh bmVvdXNdXSBmb3IgYSBzZXR1cCB0byByZWFsaXplIHRoaXMuCiAKIE91dGxpbmVzIG1ha2UgaXQg cG9zc2libGUgdG8gaGlkZSBwYXJ0cyBvZiB0aGUgdGV4dCBpbiB0aGUgYnVmZmVyLgogT3JnIHVz ZXMganVzdCB0d28gY29tbWFuZHMsIGJvdW5kIHRvIHt7e2tiZChUQUIpfX19IGFuZAote3t7a2Jk KFMtVEFCKX19fSB0byBjaGFuZ2UgdGhlIHZpc2liaWxpdHkgaW4gdGhlIGJ1ZmZlci4KK3t7e2ti ZChTLVRBQil9fX0gKH5vcmctY3ljbGV+IGFuZCB+b3JnLXNoaWZ0dGFifikgdG8gY2hhbmdlIHRo ZQordmlzaWJpbGl0eSBpbiB0aGUgYnVmZmVyLgogCiAjK2F0dHJfdGV4aW5mbzogOnNlcCAsCiAt IHt7e2tiZChUQUIpfX19IDo6Ci0tIAoyLjMwLjIKCg== --0000000000002834bc05faf014b6 Content-Type: text/x-patch; charset="US-ASCII"; name="0002-Add-names-to-a-few-list-entries.patch" Content-Disposition: attachment; filename="0002-Add-names-to-a-few-list-entries.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_lhafdmom1 RnJvbSAwOGNhZGVmZTgwOGMwMGUxODY5OTFmZWVjMGY2NmUxNDFhNzIwOTg2IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBZdXZhbCBMYW5nZXIgPHl1dmFsbGFuZ2Vyb250aGVyb2FkQHBy b3Rvbi5tZT4KRGF0ZTogRnJpLCA1IE1heSAyMDIzIDEyOjM4OjA3ICswMzAwClN1YmplY3Q6IFtQ QVRDSCAyLzJdIEFkZCBuYW1lcyB0byBhIGZldyBsaXN0IGVudHJpZXMuCgotLS0KIGRvYy9vcmct Z3VpZGUub3JnIHwgMjIgKysrKysrKysrKysrLS0tLS0tLS0tLQogMSBmaWxlIGNoYW5nZWQsIDEy IGluc2VydGlvbnMoKyksIDEwIGRlbGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL2RvYy9vcmctZ3Vp ZGUub3JnIGIvZG9jL29yZy1ndWlkZS5vcmcKaW5kZXggMzU4MWUwYTVlLi4zNzQ3ZTJkNjggMTAw NjQ0Ci0tLSBhL2RvYy9vcmctZ3VpZGUub3JnCisrKyBiL2RvYy9vcmctZ3VpZGUub3JnCkBAIC0x NDUsNyArMTQ1LDcgQEAgT3JnIHVzZXMganVzdCB0d28gY29tbWFuZHMsIGJvdW5kIHRvIHt7e2ti ZChUQUIpfX19IGFuZAogdmlzaWJpbGl0eSBpbiB0aGUgYnVmZmVyLgogCiAjK2F0dHJfdGV4aW5m bzogOnNlcCAsCi0tIHt7e2tiZChUQUIpfX19IDo6CistIHt7e2tiZChUQUIpfX19ICh+b3JnLWN5 Y2xlfikgOjoKIAogICAvU3VidHJlZSBjeWNsaW5nLzogUm90YXRlIGN1cnJlbnQgc3VidHJlZSBh bW9uZyB0aGUgc3RhdGVzCiAKQEAgLTE1NSw3ICsxNTUsNyBAQCB2aXNpYmlsaXR5IGluIHRoZSBi dWZmZXIuCiAgIFdoZW4gY2FsbGVkIHdpdGggYSBwcmVmaXggYXJndW1lbnQgKHt7e2tiZChDLXUg VEFCKX19fSksIG9yIHdpdGggdGhlCiAgIFNoaWZ0IGtleSwgZ2xvYmFsIGN5Y2xpbmcgaXMgaW52 b2tlZC4KIAotLSB7e3trYmQoUy1UQUIpfX19LCB7e3trYmQoQy11IFRBQil9fX0gOjoKKy0ge3t7 a2JkKFMtVEFCKX19fSAofm9yZy1zaGlmdHRhYn4pLCB7e3trYmQoQy11IFRBQil9fX0gOjoKIAog ICAvR2xvYmFsIGN5Y2xpbmcvOiBSb3RhdGUgdGhlIGVudGlyZSBidWZmZXIgYW1vbmcgdGhlIHN0 YXRlcwogCkBAIC0xODEsMTUgKzE4MSwxNyBAQCBiYXNpcyBieSBhZGRpbmcgYSA9U1RBUlRVUD0g a2V5d29yZCB0byA9b3ZlcnZpZXc9LCA9Y29udGVudD0sCiAKIFRoZSBmb2xsb3dpbmcgY29tbWFu ZHMganVtcCB0byBvdGhlciBoZWFkbGluZXMgaW4gdGhlIGJ1ZmZlci4KIAotLSB7e3trYmQoQy1j IEMtbil9fX0gOjogTmV4dCBoZWFkaW5nLgotCi0tIHt7e2tiZChDLWMgQy1wKX19fSA6OiBQcmV2 aW91cyBoZWFkaW5nLgorLSB7e3trYmQoQy1jIEMtbil9fX0gKH5vcmctbmV4dC12aXNpYmxlLWhl YWRpbmd+KSA6OiBOZXh0IGhlYWRpbmcuCistIHt7e2tiZChDLWMgQy1wKX19fSAofm9yZy1wcmV2 aW91cy12aXNpYmxlLWhlYWRpbmd+KSA6OiBQcmV2aW91cworICBoZWFkaW5nLgogCi0tIHt7e2ti ZChDLWMgQy1mKX19fSA6OiBOZXh0IGhlYWRpbmcgc2FtZSBsZXZlbC4KKy0ge3t7a2JkKEMtYyBD LWYpfX19ICh+b3JnLWJhY2t3YXJkLWhlYWRpbmctc2FtZS1sZXZlbH4pOjogTmV4dAorICBoZWFk aW5nIHNhbWUgbGV2ZWwuCiAKLS0ge3t7a2JkKEMtYyBDLWIpfX19IDo6IFByZXZpb3VzIGhlYWRp bmcgc2FtZSBsZXZlbC4KKy0ge3t7a2JkKEMtYyBDLWIpfX19ICh+b3V0bGluZS1iYWNrd2FyZC1z YW1lLWxldmVsfikgOjogUHJldmlvdXMKKyAgaGVhZGluZyBzYW1lIGxldmVsLgogCi0tIHt7e2ti ZChDLWMgQy11KX19fSA6OiBCYWNrd2FyZCB0byBoaWdoZXIgbGV2ZWwgaGVhZGluZy4KKy0ge3t7 a2JkKEMtYyBDLXUpfX19ICh+b3V0bGluZS11cC1oZWFkaW5nfikgOjogQmFja3dhcmQgdG8gaGln aGVyIGxldmVsIGhlYWRpbmcuCiAKICoqIFN0cnVjdHVyZSBFZGl0aW5nCiA6UFJPUEVSVElFUzoK QEAgLTE5NywxNCArMTk5LDE0IEBAIFRoZSBmb2xsb3dpbmcgY29tbWFuZHMganVtcCB0byBvdGhl ciBoZWFkbGluZXMgaW4gdGhlIGJ1ZmZlci4KIDpFTkQ6CiAKICMrYXR0cl90ZXhpbmZvOiA6c2Vw ICwKLS0ge3t7a2JkKE0tUkVUKX19fSA6OgorLSB7e3trYmQoTS1SRVQpfX19ICh+b3JnLW1ldGEt cmV0dXJufikgOjoKIAogICBJbnNlcnQgbmV3IGhlYWRpbmcgd2l0aCBzYW1lIGxldmVsIGFzIGN1 cnJlbnQuICBJZiBwb2ludCBpcyBpbgogICBhIHBsYWluIGxpc3QgaXRlbSwgYSBuZXcgaXRlbSBp cyBjcmVhdGVkIChzZWUgW1tQbGFpbiBMaXN0c11dKS4gIFdoZW4KICAgdGhpcyBjb21tYW5kIGlz IHVzZWQgaW4gdGhlIG1pZGRsZSBvZiBhIGxpbmUsIHRoZSBsaW5lIGlzIHNwbGl0IGFuZAogICB0 aGUgcmVzdCBvZiB0aGUgbGluZSBiZWNvbWVzIHRoZSBuZXcgaGVhZGxpbmVbZm46Ml0uCiAKLS0g e3t7a2JkKE0tUy1SRVQpfX19IDo6CistIHt7e2tiZChNLVMtUkVUKX19fSAofm9yZy1pbnNlcnQt dG9kby1oZWFkaW5nfikgOjoKIAogICBJbnNlcnQgbmV3IFRPRE8gZW50cnkgd2l0aCBzYW1lIGxl dmVsIGFzIGN1cnJlbnQgaGVhZGluZy4KIAotLSAKMi4zMC4yCgo= --0000000000002834bc05faf014b6--