unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#6344: 24.0.50; doc of menu separators
@ 2010-06-03 17:56 Drew Adams
  2010-12-29 15:39 ` Drew Adams
  0 siblings, 1 reply; 5+ messages in thread
From: Drew Adams @ 2010-06-03 17:56 UTC (permalink / raw)
  To: 6344

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'
 






^ permalink raw reply	[flat|nested] 5+ messages in thread

* bug#6344: 24.0.50; doc of menu separators
  2010-06-03 17:56 bug#6344: 24.0.50; doc of menu separators Drew Adams
@ 2010-12-29 15:39 ` Drew Adams
  2011-07-13 22:16   ` Lars Magne Ingebrigtsen
  0 siblings, 1 reply; 5+ messages in thread
From: Drew Adams @ 2010-12-29 15:39 UTC (permalink / raw)
  To: 6344

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.






^ permalink raw reply	[flat|nested] 5+ messages in thread

* bug#6344: 24.0.50; doc of menu separators
  2010-12-29 15:39 ` Drew Adams
@ 2011-07-13 22:16   ` Lars Magne Ingebrigtsen
  2011-07-13 22:43     ` Drew Adams
  0 siblings, 1 reply; 5+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-13 22:16 UTC (permalink / raw)
  To: Drew Adams; +Cc: 6344

"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/





^ permalink raw reply	[flat|nested] 5+ messages in thread

* bug#6344: 24.0.50; doc of menu separators
  2011-07-13 22:16   ` Lars Magne Ingebrigtsen
@ 2011-07-13 22:43     ` Drew Adams
  2011-07-13 23:17       ` Lars Magne Ingebrigtsen
  0 siblings, 1 reply; 5+ messages in thread
From: Drew Adams @ 2011-07-13 22:43 UTC (permalink / raw)
  To: 'Lars Magne Ingebrigtsen'; +Cc: 6344

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






^ permalink raw reply	[flat|nested] 5+ messages in thread

* bug#6344: 24.0.50; doc of menu separators
  2011-07-13 22:43     ` Drew Adams
@ 2011-07-13 23:17       ` Lars Magne Ingebrigtsen
  0 siblings, 0 replies; 5+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-13 23:17 UTC (permalink / raw)
  To: Drew Adams; +Cc: 6344

"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/





^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2011-07-13 23:17 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2010-06-03 17:56 bug#6344: 24.0.50; doc of menu separators Drew Adams
2010-12-29 15:39 ` Drew Adams
2011-07-13 22:16   ` Lars Magne Ingebrigtsen
2011-07-13 22:43     ` Drew Adams
2011-07-13 23:17       ` Lars Magne Ingebrigtsen

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).