From debbugs-submit-bounces@debbugs.gnu.org Mon Jul 17 16:44:34 2023 Received: (at submit) by debbugs.gnu.org; 17 Jul 2023 20:44:34 +0000 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 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 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 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 Date: Mon, 17 Jul 2023 20:44:04 +0000 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== To: "bug-gnu-emacs@gnu.org" From: uzibalqa Subject: Documentation for the definition of a Menu Item Message-ID: Feedback-ID: 52887082:user:proton MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable 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-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) 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 From debbugs-submit-bounces@debbugs.gnu.org Tue Jul 18 07:03:32 2023 Received: (at 64693-done) by debbugs.gnu.org; 18 Jul 2023 11:03:32 +0000 Received: from localhost ([127.0.0.1]:51672 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qLiUO-0005xd-2m for submit@debbugs.gnu.org; Tue, 18 Jul 2023 07:03:32 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:40494) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qLiUM-0005xL-FF for 64693-done@debbugs.gnu.org; Tue, 18 Jul 2023 07:03:30 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qLiUF-0007MG-9c; Tue, 18 Jul 2023 07:03:23 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=nFkLLNmgj4SbToCpJpraW1eYqEvsiMQXuplfa26GC7k=; b=ACRp8xOSACge2bg3Tq1O +0AlOmGFudqjl480m8H+/uENwoYp/LUpCLdVcolp6j9kpD5OrKcRM5u6h2QDHOQW4/etQaD9IC7FJ mo6yf0vTQcV/Aw+v5BqHGu21nj8WlGWGrIELCnoSPQOOToVL2IaG5RY6C+7SWfaE5XrELi25zzWRN mFkv9oIWa350ShKkCg3BLNN4v9byNscGZweI7vQtPV39C9CK7KmuviA5TkJuoCRqhVGgjkZa2INid nTo3+9nVv5eJSrmA5bwSJWSWr1/giUZNtEM94R4hlUTgC7PrBSpzv+BI9MQBMHXRTjKkp4tZedMh0 vcpiqFBEuu2HtA==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qLiU2-0003qH-Rg; Tue, 18 Jul 2023 07:03:21 -0400 Date: Tue, 18 Jul 2023 14:03:32 +0300 Message-Id: <83o7k97a7v.fsf@gnu.org> From: Eli Zaretskii To: uzibalqa In-Reply-To: (bug-gnu-emacs@gnu.org) Subject: Re: bug#64693: Documentation for the definition of a Menu Item References: MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 64693-done Cc: 64693-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Mon, 17 Jul 2023 20:44:04 +0000 > From: uzibalqa via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" > > > 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 > > (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. If you type "i property list RET" in Info, you will land in the "Property Lists" node, which starts by saying: A “property list” (“plist” for short) is a list of paired elements. Each of the pairs associates a property name (usually a symbol) with a property or value. So I think when the manual says that item-property-list is a property list, it does a good job. > Furthermore, a more comprehensive explanation of Cons Cells, Dotted > Notation, and Backquote Construct, should be introduced and backed up > with real-life syntax such as the one described here. This is all properly done elsewhere in the manual; see my response to your report in bug#64692. So I'm closing this bug. From debbugs-submit-bounces@debbugs.gnu.org Tue Jul 18 07:35:44 2023 Received: (at 64693-done) by debbugs.gnu.org; 18 Jul 2023 11:35:44 +0000 Received: from localhost ([127.0.0.1]:51750 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qLizY-0000st-BT for submit@debbugs.gnu.org; Tue, 18 Jul 2023 07:35:44 -0400 Received: from mail-40140.protonmail.ch ([185.70.40.140]:16983) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qLizU-0000sd-EG for 64693-done@debbugs.gnu.org; Tue, 18 Jul 2023 07:35:42 -0400 Date: Tue, 18 Jul 2023 11:35:27 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=proton.me; s=protonmail; t=1689680134; x=1689939334; bh=n+gW0X23k0l5QQfECxYUGIrhl/gotqmmJ33RR6YIAbY=; h=Date:To:From:Cc:Subject:Message-ID:In-Reply-To:References: Feedback-ID:From:To:Cc:Date:Subject:Reply-To:Feedback-ID: Message-ID:BIMI-Selector; b=X18H58CybDWEixC5SrE4V6nTJEd/c7K2M8dB2yG35noGwwnX8XQL6hS9iTMnjOkxs qjygQ2NB6mjHEDzPCo3Qt1PwO2IXO0Y1EI9sXuM40ExQBh3EyXSdvktuUzpxKJl8gm +6Tg4/Hd4IZL9SkfF07/MQOsHmk6ZkryQfGcZ7THPXLt3oymlh7QDPF5Y6/qgydV8c z90NAH/Pk1462USTIrk0LWmbilOUkI4tZ5uK03VMvw1gTUtjm6734aSNm9JpTnwIYE cwlHgf6YeLlIdS/r6dfm/441/3TO59HBSCFhiYjjru6EomPiUmdWGjBZ2Jk5oFjG2h 79Tuja40oTGcg== To: Eli Zaretskii From: uzibalqa Subject: Re: bug#64693: Documentation for the definition of a Menu Item Message-ID: In-Reply-To: <83o7k97a7v.fsf@gnu.org> References: <83o7k97a7v.fsf@gnu.org> Feedback-ID: 52887082:user:proton MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 64693-done Cc: 64693-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) ------- Original Message ------- On Tuesday, July 18th, 2023 at 11:03 PM, Eli Zaretskii wrote= : > > Date: Mon, 17 Jul 2023 20:44:04 +0000 > > From: uzibalqa via "Bug reports for GNU Emacs, > > the Swiss army knife of text editors" bug-gnu-emacs@gnu.org > >=20 > > Have been looking at the documentation for 'DEF' in 'define-key'. > >=20 > > (define-key KEYMAP KEY DEF &optional REMOVE) > >=20 > > DEF, the definition of a Menu Item is described in form as > >=20 > > (menu-item item-name binding . item-property-list) Looking at "23.17.1.1 Simple Menu Items" nowhere does it say that the vector of symbols is equivalent to the sequence of keystrokes=20 when using keyboard bindings (key sequences). =20 =20 > > 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. > >=20 > > But such detail is not properly described. >=20 >=20 > If you type "i property list RET" in Info, you will land in the > "Property Lists" node, which starts by saying: >=20 > A =E2=80=9Cproperty list=E2=80=9D (=E2=80=9Cplist=E2=80=9D for short) is = a list of paired elements. > Each of the pairs associates a property name (usually a symbol) with a > property or value. Provide a cross-reference to 'property list' in "23.17.1.2 Extended Menu It= ems". =20 > So I think when the manual says that item-property-list is a property > list, it does a good job. >=20 > > Furthermore, a more comprehensive explanation of Cons Cells, Dotted > > Notation, and Backquote Construct, should be introduced and backed up > > with real-life syntax such as the one described here. >=20 >=20 > This is all properly done elsewhere in the manual; see my response to > your report in bug#64692. >=20 > So I'm closing this bug. > From debbugs-submit-bounces@debbugs.gnu.org Tue Jul 18 08:57:57 2023 Received: (at 64693-done) by debbugs.gnu.org; 18 Jul 2023 12:57:57 +0000 Received: from localhost ([127.0.0.1]:52061 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qLkH7-0003Op-11 for submit@debbugs.gnu.org; Tue, 18 Jul 2023 08:57:57 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:58990) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qLkH2-0003Oa-P7 for 64693-done@debbugs.gnu.org; Tue, 18 Jul 2023 08:57:55 -0400 Received: from fencepost.gnu.org ([209.51.188.10]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qLkGx-0001Qy-AR; Tue, 18 Jul 2023 08:57:47 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=EZZYzOy5DoTDCjMELRbkZyCgOHnWBnJxHHjL994TmG4=; b=HjyKEn0Op+jlJxbgP0Ky XVUzumB/nOlz+tKMtRCxbF2I75fgu7agDaB8k3Ypsc7IpBNbik77wcCm9mdDFyYjF7gGdcrGEpZek KLKBfi+PDYKJGyi4l8PvKELTadAYUtPBEEFD6zGmiw2takqlOTpER6L4J6vipSk7u3bb6esbkKGNc EwEkPWz/qMrvQo1cQ9NJk42vIdNUalDHkE6WmdXNaQaOzfBLeEqKQzAqeQqzdIpad1Y+zCykTrYZg ZmLTQ5vuG12ZHc6CC2Nr2YEnF+sEy7LEEi28EbmY70XpUf7xNnKry3ZvrwuITCf6PfyBoonDoaRUS NnfgyP3rXDEzcw==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qLkGv-0000j7-UX; Tue, 18 Jul 2023 08:57:46 -0400 Date: Tue, 18 Jul 2023 15:58:15 +0300 Message-Id: <838rbd74wo.fsf@gnu.org> From: Eli Zaretskii To: uzibalqa In-Reply-To: (message from uzibalqa on Tue, 18 Jul 2023 11:35:27 +0000) Subject: Re: bug#64693: Documentation for the definition of a Menu Item References: <83o7k97a7v.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 64693-done Cc: 64693-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Tue, 18 Jul 2023 11:35:27 +0000 > From: uzibalqa > Cc: 64693-done@debbugs.gnu.org > > > A “property list” (“plist” for short) is a list of paired elements. > > Each of the pairs associates a property name (usually a symbol) with a > > property or value. > > Provide a cross-reference to 'property list' in "23.17.1.2 Extended Menu Items". Done, thanks. From unknown Mon Jun 23 04:13:42 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 16 Aug 2023 11:24:15 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator