From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: uzibalqa via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#64693: Documentation for the definition of a Menu Item Date: Mon, 17 Jul 2023 20:44:04 +0000 Message-ID: Reply-To: uzibalqa Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="26121"; mail-complaints-to="usenet@ciao.gmane.io" To: 64693@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Jul 17 22:45:19 2023 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 1qLV5p-0006Y7-LO for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 17 Jul 2023 22:45:17 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qLV5i-0004UQ-V7; Mon, 17 Jul 2023 16:45:10 -0400 Original-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 1qLV5b-0004Tx-Kx for bug-gnu-emacs@gnu.org; Mon, 17 Jul 2023 16:45:03 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qLV5b-0005RG-29 for bug-gnu-emacs@gnu.org; Mon, 17 Jul 2023 16:45:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qLV5a-0008TY-Hz for bug-gnu-emacs@gnu.org; Mon, 17 Jul 2023 16:45:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: uzibalqa Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 17 Jul 2023 20:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 64693 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.168962667432529 (code B ref -1); Mon, 17 Jul 2023 20:45:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 17 Jul 2023 20:44:34 +0000 Original-Received: from localhost ([127.0.0.1]:51036 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qLV57-0008Sb-WE for submit@debbugs.gnu.org; Mon, 17 Jul 2023 16:44:34 -0400 Original-Received: from lists.gnu.org ([2001:470:142::17]:36412) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qLV55-0008SO-UK for submit@debbugs.gnu.org; Mon, 17 Jul 2023 16:44:32 -0400 Original-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 1qLV50-0003zr-NB for bug-gnu-emacs@gnu.org; Mon, 17 Jul 2023 16:44:26 -0400 Original-Received: from mail-4319.protonmail.ch ([185.70.43.19]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qLV4r-0005L8-9X for bug-gnu-emacs@gnu.org; Mon, 17 Jul 2023 16:44:26 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=proton.me; s=protonmail; t=1689626654; x=1689885854; bh=IkZEI6ykHiXawG4yguzg3kGBtCXW9j8OBn9lO0kUPPc=; h=Date:To:From:Subject:Message-ID:Feedback-ID:From:To:Cc:Date: Subject:Reply-To:Feedback-ID:Message-ID:BIMI-Selector; b=IlbwNSzUbKlwKGTfqirYBHint0CaIGMs7ITa4bqDrdZhYZNAxs9vp9OQIh34/F/D3 Si/90UZbWqMki9yiiFJ5Ei83UkB65W9TMXzN72Un3ZAXyLSN+tTu0JNqra83q4zpgm vd1Qt7krIqhEwCttXe3Rvy7n3YK/O/loeEaGqL7YmtFXf2DY9xJjWhEf5W9HDr/yED RvrkIx2QID/9yHMssmt6N7ZsPJHFzXgCfr/SJWoBWogguDQSFx8UOepoUZP2+rzt8o oLjUxrrViL9f1/2YwIKhJvOEj3h3xPLsqKASS4PKCOTBWiLYv5aLZBXi1ajZPrXjws kAgPFRLttHZZQ== Feedback-ID: 52887082:user:proton Received-SPF: pass client-ip=185.70.43.19; envelope-from=uzibalqa@proton.me; helo=mail-4319.protonmail.ch 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, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-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: 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:265414 Archived-At: Have been looking at the documentation for 'DEF' in 'define-key'. (define-key KEYMAP KEY DEF &optional REMOVE) DEF, the definition of a Menu Item is described in form as=20 (menu-item item-name binding . item-property-list) Note that DEF constitutes a single list. The special dotted notation indicates that 'item-property-list' is not a separate list but rather enables any number of property elements in the form of ':keyword value' within the same list structure. But such detail is not properly described. Pointing out how the description of 'Cons Cells' and 'Dotted Notation' is sketchy at best in the 'Elisp Reference Manual', and non-existent in=20 the 'Introduction to Programming in Emacs Lisp', the aforementioned description should be added in the documentation of 'define-key'. Furthermore, a more comprehensive explanation of Cons Cells, Dotted Notation, and Backquote Construct, should be introduced and backed up=20 with real-life syntax such as the one described here. =20