GTK_STOCK icons vs. named spec

2008-11-17 Thread John Daiker

Hello All,

First off, apologies for the widespread distribution of this e-mail.  I 
figure start big, and then the appropriate list can assist from there.


Second, I just signed up to the list (gtk-app-devel-list), but had a 
specific question about using the GTK_STOCK_* naming convention versus 
the 'defined text'.  (eg: GTK_STOCK_SAVE vs 'gtk-save'  and   
GTK_STOCK_CLOSE vs 'gtk-close')
Rhythmbox currently uses the GTK_STOCK_* convention, but it has been 
brought up recently 
(http://bugzilla.gnome.org/show_bug.cgi?id=560349#c5) that perhaps this 
convention is 'bad habit'.


Just looking for some insight into this, and maybe to get a feel for 
what the community views as the 'best practice'.


Thanks,
John Daiker
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
http://mail.gnome.org/mailman/listinfo/gtk-devel-list


Re: GTK_STOCK icons vs. named spec

2008-11-17 Thread Christian Dywan
Am Thu, 13 Nov 2008 21:56:29 -0800
schrieb John Daiker [EMAIL PROTECTED]:

 Hello All,
 
 First off, apologies for the widespread distribution of this e-mail.
 I figure start big, and then the appropriate list can assist from
 there.
 
 Second, I just signed up to the list (gtk-app-devel-list), but had a 
 specific question about using the GTK_STOCK_* naming convention
 versus the 'defined text'.  (eg: GTK_STOCK_SAVE vs 'gtk-save'  and   
 GTK_STOCK_CLOSE vs 'gtk-close')
 Rhythmbox currently uses the GTK_STOCK_* convention, but it has been 
 brought up recently 
 (http://bugzilla.gnome.org/show_bug.cgi?id=560349#c5) that perhaps
 this convention is 'bad habit'.
 
 Just looking for some insight into this, and maybe to get a feel for 
 what the community views as the 'best practice'.

Hey John,

if the question is whether to use a stock ID or a named icon, there are
a few points to regard:

- A stock ID can refer to multiple icon names
- A stock icon is guaranteed to exist (exception: GTK_STOCK_DISCARD)
- A stock ID can and usually does include a label
- A stock icon can have an RTL variant

Basically you can use an icon name wherever you need no icon, and of
course you *should* use an icon name where there is no stock ID.
However at the same time, your must be aware that unless you ship the
icon with your application, that without a theme containing the icon
name your application is basically broken.

ciao,
Christian
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
http://mail.gnome.org/mailman/listinfo/gtk-devel-list


GTK_STOCK icons vs. named spec

2008-11-13 Thread John Daiker

Hello All,

First off, apologies for the widespread distribution of this e-mail.  I 
figure start big, and then the appropriate list can assist from there.


Second, I just signed up to the list (gtk-app-devel-list), but had a 
specific question about using the GTK_STOCK_* naming convention versus 
the 'defined text'.  (eg: GTK_STOCK_SAVE vs 'gtk-save'  and   
GTK_STOCK_CLOSE vs 'gtk-close')
Rhythmbox currently uses the GTK_STOCK_* convention, but it has been 
brought up recently 
(http://bugzilla.gnome.org/show_bug.cgi?id=560349#c5) that perhaps this 
convention is 'bad habit'.


Just looking for some insight into this, and maybe to get a feel for 
what the community views as the 'best practice'.


Thanks,
John Daiker
___
gtk-app-devel-list mailing list
gtk-app-devel-list@gnome.org
http://mail.gnome.org/mailman/listinfo/gtk-app-devel-list