GNU bug report logs - #64693
Documentation for the definition of a Menu Item

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#64693: closed (Documentation for the definition of a Menu Item)
Date: Tue, 18 Jul 2023 11:04:01 +0000

[Message part 1 (text/plain, inline)]

Your message dated Tue, 18 Jul 2023 14:03:32 +0300
with message-id <83o7k97a7v.fsf <at> gnu.org>
and subject line Re: bug#64693: Documentation for the definition of a Menu Item
has caused the debbugs.gnu.org bug report #64693,
regarding Documentation for the definition of a Menu Item
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
64693: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=64693
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: uzibalqa <uzibalqa <at> proton.me>
To: "bug-gnu-emacs <at> gnu.org" <bug-gnu-emacs <at> gnu.org>
Subject: Documentation for the definition of a Menu Item
Date: Mon, 17 Jul 2023 20:44:04 +0000

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.  Pointing out how
the description of 'Cons Cells' and 'Dotted Notation' is sketchy
at best in the 'Elisp Reference Manual', and non-existent  in 
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 
with real-life syntax such as the one described here.

  

[Message part 3 (message/rfc822, inline)]

From: Eli Zaretskii <eliz <at> gnu.org>
To: uzibalqa <uzibalqa <at> proton.me>
Cc: 64693-done <at> debbugs.gnu.org
Subject: Re: bug#64693: Documentation for the definition of a Menu Item
Date: Tue, 18 Jul 2023 14:03:32 +0300

> 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 <at> gnu.org>
> 
> 
> 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.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.