GNU bug report logs - #6344
24.0.50; doc of menu separators

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 6344 in the body.
You can then email your comments to 6344 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 24.0.50; doc of menu separators
Date: Thu, 3 Jun 2010 10:56:07 -0700

emacs -Q
 
C-h i, Elisp manual.
 
Node `Extended Menu Items' says only this about separators:
 
"A string starting with two or more dashes specifies a separator line;
see *Note Menu Separators::."
 
Node `Menu Separators' says, likewise, that this is all that is
permitted: (menu-item SEPARATOR-TYPE)
 
A user will naturally wonder, "Is there no way to specify :enable or
:visible for a menu separator?"
 
In fact, there is a way, simply use:

 (menu-item SEPARATOR-TYPE nil :visible PREDICATE)

etc.
 
In sum, the doc (spec) for separators is incomplete.
 

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2010-05-23 on G41R2F1
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/xpm/include'
 

Message #8 received at 6344 <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <6344 <at> debbugs.gnu.org>
Subject: RE: bug#6344: 24.0.50; doc of menu separators
Date: Wed, 29 Dec 2010 07:39:02 -0800

Ping.

I just spent some time myself rediscovering this.
Can we please fix the doc to mention this?  Thx.

> A user will naturally wonder, "Is there no way to specify :enable or
> :visible for a menu separator?"  In fact, there is a way, simply use:
>  (menu-item SEPARATOR-TYPE nil :visible PREDICATE)
> etc.
>  
> In sum, the doc (spec) for separators is incomplete.

Message #11 received at 6344 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 6344 <at> debbugs.gnu.org
Subject: Re: bug#6344: 24.0.50; doc of menu separators
Date: Thu, 14 Jul 2011 00:16:43 +0200

"Drew Adams" <drew.adams <at> oracle.com> writes:

> I just spent some time myself rediscovering this.
> Can we please fix the doc to mention this?  Thx.
>
>> A user will naturally wonder, "Is there no way to specify :enable or
>> :visible for a menu separator?"  In fact, there is a way, simply use:
>>  (menu-item SEPARATOR-TYPE nil :visible PREDICATE)
>> etc.
>>  
>> In sum, the doc (spec) for separators is incomplete.

Could you suggest an appropriate text for the manual?

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Message #14 received at 6344 <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Lars Magne Ingebrigtsen'" <larsi <at> gnus.org>
Cc: 6344 <at> debbugs.gnu.org
Subject: RE: bug#6344: 24.0.50; doc of menu separators
Date: Wed, 13 Jul 2011 15:43:58 -0700

> > I just spent some time myself rediscovering this.
> > Can we please fix the doc to mention this?  Thx.
> >
> >> A user will naturally wonder, "Is there no way to specify 
> >> :enable or :visible for a menu separator?"  In fact, there
> >> is a way, simply use:
> >>  (menu-item SEPARATOR-TYPE nil :visible PREDICATE)
> >> etc.
> >>  
> >> In sum, the doc (spec) for separators is incomplete.
> 
> Could you suggest an appropriate text for the manual?

I think all we need to say is something like this (in node `Menu Separators'):



You can use this longer form to specify keywords such as :enable and :visible
for a menu separator:

  (menu-item SEPARATOR-TYPE nil . ITEM-PROPERTY-LIST)

For example:

  (menu-item "--" nil :visible (boundp 'foo))

Message #21 received at 6344 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 6344 <at> debbugs.gnu.org
Subject: Re: bug#6344: 24.0.50; doc of menu separators
Date: Thu, 14 Jul 2011 01:17:56 +0200

"Drew Adams" <drew.adams <at> oracle.com> writes:

> I think all we need to say is something like this (in node `Menu Separators'):
>
> You can use this longer form to specify keywords such as :enable and :visible
> for a menu separator:
>
>   (menu-item SEPARATOR-TYPE nil . ITEM-PROPERTY-LIST)
>
> For example:
>
>   (menu-item "--" nil :visible (boundp 'foo))

Thanks; I've now added this.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Previous Next

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