bug#6344: 24.0.50; doc of menu separators

bug#6344: 24.0.50; doc of menu separators

[Drew Adams]

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'
 

bug#6344: 24.0.50; doc of menu separators

[Drew Adams]

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.

bug#6344: 24.0.50; doc of menu separators

[Lars Magne Ingebrigtsen]

"Drew Adams" <drew.adams@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/

bug#6344: 24.0.50; doc of menu separators

[Drew Adams]

> > 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))

bug#6344: 24.0.50; doc of menu separators

[Lars Magne Ingebrigtsen]

"Drew Adams" <drew.adams@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/