From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Po Lu via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#64692: Better descriptions of Cons Cells and Dotted Notation with real-life syntax Date: Tue, 18 Jul 2023 18:32:55 +0800 Message-ID: <87jzux5x2g.fsf@yahoo.com> References: Reply-To: Po Lu Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="12877"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 64692-done@debbugs.gnu.org To: uzibalqa Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Jul 18 12:34:15 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 1qLi22-00037G-RW for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 18 Jul 2023 12:34:14 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qLi1w-0008DN-Dh; Tue, 18 Jul 2023 06:34:08 -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 1qLi1q-0008CS-S6 for bug-gnu-emacs@gnu.org; Tue, 18 Jul 2023 06:34:02 -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 1qLi1q-00080S-K8 for bug-gnu-emacs@gnu.org; Tue, 18 Jul 2023 06:34:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qLi1q-00056L-FT for bug-gnu-emacs@gnu.org; Tue, 18 Jul 2023 06:34:02 -0400 Resent-From: Po Lu Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Tue, 18 Jul 2023 10:34:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 64692 X-GNU-PR-Package: emacs Mail-Followup-To: 64692@debbugs.gnu.org, luangruo@yahoo.com, uzibalqa@proton.me Original-Received: via spool by 64692-done@debbugs.gnu.org id=D64692.168967639119546 (code D ref 64692); Tue, 18 Jul 2023 10:34:02 +0000 Original-Received: (at 64692-done) by debbugs.gnu.org; 18 Jul 2023 10:33:11 +0000 Original-Received: from localhost ([127.0.0.1]:51631 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qLi10-00055B-Nn for submit@debbugs.gnu.org; Tue, 18 Jul 2023 06:33:11 -0400 Original-Received: from sonic316-22.consmr.mail.ne1.yahoo.com ([66.163.187.148]:32944) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qLi0z-000550-Fj for 64692-done@debbugs.gnu.org; Tue, 18 Jul 2023 06:33:09 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1689676384; bh=7wZuVQBBJ9QqmvxloDpKcULEsDp9jNr5ljUZpwTO1Lo=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From:Subject:Reply-To; b=BhQWcMrMzUS3nUo3XpaHohPXBbsT6n/ZG8VTCIx3lE2+VnBquFjkDWGJyO+fdu6BdmcWnhvVPF51ZWXZXQZM3BeW252fPKJY4IAO/Eg2UymgoKVw/49rB8cnygflR7hpLu/EK3xomBZBklKbiiqmi98EaXpgsj4iRreWXFFITrNcu407vzj+vvty4i4wazOPZYHJZ8VXh75ci6uvamQ/nNuWm9zGO09scOrVzubN20KPB0dBofd+eRa0Zi/cEVU0vZattiRPOOVGa/1nYLGEj6BIs7sBkmhOgXBvqa5SDvVSWDm/MU5wqWx8RD/5vkbfysDd/leeKYGO/aWojZCAow== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1689676384; bh=S5FYCNdwNGnsUnSfKm3JmsGPGau3iEX5+8MvLx01jak=; h=X-Sonic-MF:From:To:Subject:Date:From:Subject; b=q1bw+/xFid3uiy2jBWrL1OUic4UxAmW4m/d96yIw/93nehNNT+rr6fjwZGxwXqs7qCCNq6RhWOBabtRR0yEYe5y6DUALTj9oLhZ8KKFHWMQyqtAq4m5nDTP2JE6NpUBJRjhwywFl2J1fD6/BsUGcSIJUJnK1aFWo45mxoFOGl8r02EmC1w3m1l6RBTioU5OWONLt1+rohKVk6ucWpnHZj+pLPRK/bSZGNdiDRao+lOxxstshFkHUapT2q0hTXZewme3CrtBlP+VWwE19bqMS1/uDOr/I0ebmHegGq0TZyktvXCArghcUe7kNYQti+TReOZPjTqe1chAXfKhtptLxgQ== X-YMail-OSG: Hp7BK8AVM1miBEvJmgLbS4U5oTPKz6S8iPzwQmq5dpw1b7zcIqmMM42yTY.HmmD wT1RmK0Wp7WEc.ebM7ufFdMWoGT3CrtK.XZ3B_7Sg0k4u_OU.l0XG1WZntggaDRXRTQVKWw3c4.S fvAbFBqMYUo1mOFJv.YNN1xSZwBHol8mgwFHbTyY92iOr538jI_t9D9Wdrq0Bk6Nwn2JwbhyRlnE h0gdl1XMTqD8pjxUnUgkeVKeB_smG2yuJxiWCDDXpDOHVod4uJxwa3a3jp3wBfl0A.Awl_HOYLN8 jqRDZoyB0GclzMQ5yLDOlwPPK8TMuq5h3IFGjz6s41X1erzDYQcPL0W1CoUP6w.E_.5DrAiM0zmT Kng6jjiq7oYsNTDCk6iKOXqeai5LGwauWr0yHQItvs4KdvlAHD55NlaZXO7Y7hbjCvPNnI70_fdS tRrUOQdTtdgvWNDdtUv1BovMTqwZs17hY9krq8eMZY7kh5Qe5Wzv5x1KYl2ObJQVcUzKMv2ZXqvr yGnp9UqZBfZjlB6Yn_cAFk2OszeWy5M3Q.L5WVLTL7TDEhScGj_h5mI7gPwGhbTMCBUXvaCagHVX OfI8qyumAr4MEPR_QlPEJd4uYwsX.D81xhvrJXBw3DYk8kwu9M9HnHzQgntnGRTw6rujVSdhIRrs y7SH22L8z4xaA3mx77zETcyIIKgd6DcTKmfJZb_rcWoKAZZgbv7PraTTvNOwRjw7kGDObNtaTcqN KH8xY0ZDSTiw5n6F7nx_u590kz43_sNXYKnyzlOf4xg8I8ju0J8rcfuEVpAS5l2ZH6RbjvCVR890 A0yBeccsCaI_L7vXSJRs2.C2PqRoRb0pdYWv7HZLi5 X-Sonic-MF: X-Sonic-ID: bc125cd8-fd64-44e1-8fe4-e836702ab6f3 Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic316.consmr.mail.ne1.yahoo.com with HTTP; Tue, 18 Jul 2023 10:33:04 +0000 Original-Received: by hermes--production-sg3-9dc5f54fc-9znrz (Yahoo Inc. Hermes SMTP Server) with ESMTPA ID 09e61c593f29df1596199005f6110a52; Tue, 18 Jul 2023 10:32:59 +0000 (UTC) In-Reply-To: (uzibalqa@proton.me's message of "Mon, 17 Jul 2023 20:17:19 +0000") X-Mailer: WebService/1.1.21647 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo 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:265433 Archived-At: uzibalqa writes: > Have been looking at the documentation of menu-item described as > > (menu-item item-name real-binding . item-property-list) > > This requires a good understanding of Cons Cells and Dotted Notation. > But I do not see a serious attempt to explain this. Whereas the Emacs > Lisp Reference Manual isn't designed as a tutorial with explanations, > the "Introduction to Programming in Emacs Lisp" simply refers to the > "Emacs Lisp Reference Manual" for understanding Cons Cells and Dotted Notation. > > This means that the "Introduction to Programming in Emacs Lisp" would benefit > from some real-life list syntax. Currently I find it short and far from real-life. > > For instance, whilst it cam became natural for users to make menus. it would be > difficult for them to understand that > > (menu-item item-name real-binding . item-property-list) > > describes how "item-property-list" would not produce a list inside a list, but a > single "(menu-item ..." list. > > In general, the construction of menus should be better described as it is currently > too theoretical in the reference. The node containing your example is located in the Emacs Lisp reference manual, which contains two adequate descriptions of both dotted lists and dotted pair notation. I see no problem here; closing.