RE: [External] : menu-item uses no dot period before item-property-list in examples

[uzibalqa]

------- Original Message -------
On Monday, July 17th, 2023 at 12:52 PM, Drew Adams <drew.adams@oracle.com> 
wrote:


> > > Have read about
> > 
> > (menu-item item-name real-binding . item-property-list)
> > 
> > but when things actually get implemented there exist no dot period
> > before 'item-property-list'.
> > 
> > (define-key global-map
> > [menu-bar mcp-topm daphne-subm entry-sweep]
> > '(menu-item "Entry Sweep" gilgamesh-entry-sweep
> > :help "Entry Sweep"))
> 
> 
> Yes, there is. And you've been told before
> that (a . (b c)) is the same as (a b c).
> 
> For simplicity, Lisp printing removes the
> dot and parens: . (...). This is standard
> Lisp syntax convenience: we write (a b c)
> instead of (a . (b . (c . nil))). That's
> all there is to it.

So why bother users in the manual why that is never actually used.

(menu-item item-name real-binding item-property-list)
 
> And you've asked this before, and you've
> been pointed to the Elisp doc, which
> explains all of this in detail, even with
> diagrams and examples.
> 
> Please, Ask Emacs. Many people, over many
> years, have gone to the trouble of writing
> good, clear help and doc.

That's your assertion.  Bothering us with jargon that never gets used is 
just being silly to those who do not have time for nonsense intended only
for general language interest rather than practicality.

The dot should be removed from the documentation and have


 
> And you can find the same thing outside of
> Emacs, in any number of Lisp introductions.
> 
> Help yourself.