[opensuse-packaging] Fixing package conventions
Hi, I found several errors on http://en.opensuse.org/SUSE_Package_Conventions/Desktop_Menu What is the process to fix them? I guess it's a bit more complex than just editing the wiki page? Here are the errors: + the xboard example has this line: "Categories=Game;BoardGame" It's missing a ; at the end of the line + Encoding explicitly defines the encoding used in the desktop file. The value “UTF-8” should be used. => the Encoding key is deprecated now, and shouldn't be used any more. The files are always UTF-8 encoded. + Icon defines the icon connected with the application. The value is an icon name without a suffix. Only the .png and .xpm icons are supported. They must be installed either below /usr/share/pixmaps/ or below /opt/gnome/share/pixmaps/. => the value can also be a path to an icon. The icon should be installed according to the guidelines defined in the icon theme specification if possible. + GenericName defines a comment that can be shown in a tool tip. It was defined by the key Comment in old desktop files. => that's wrong. The tooltip is still defined by the Comment key according to the spec. + the emacs.desktop example is not valid: Terminal=0 should be Terminal=false Also, X-KDE-StartupNotify=true should probably be StartupNotify=true and X-KDE-WMClass should be StartupWMClass + I'm confused by the list of categories. Some of them are not defined in the menus spec and shouldn't be used. It's not clear whether the small text above the categories implies that they should be prefixed with "X-SuSE-"? Vincent -- Les gens heureux ne sont pas pressés. --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-packaging+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-packaging+help@opensuse.org
* Vincent Untz (vuntz@novell.com) [20080318 13:41]:
Hi,
I found several errors on http://en.opensuse.org/SUSE_Package_Conventions/Desktop_Menu What is the process to fix them? I guess it's a bit more complex than just editing the wiki page?
AFAIK, it *is* as easy as editing the wiki page :) Philipp --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-packaging+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-packaging+help@opensuse.org
Philipp Thomas wrote:
* Vincent Untz (vuntz@novell.com) [20080318 13:41]:
Hi,
I found several errors on http://en.opensuse.org/SUSE_Package_Conventions/Desktop_Menu What is the process to fix them? I guess it's a bit more complex than just editing the wiki page?
AFAIK, it *is* as easy as editing the wiki page :)
But posting an explanation to the mailing list surely doesn't do any harm. And it's in fact easier to explain the needed changes here than in the tiny "Summary" field in the wiki edit form ;) Michal --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-packaging+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-packaging+help@opensuse.org
* Michal Marek (mmarek@suse.cz) [20080318 16:02]:
But posting an explanation to the mailing list surely doesn't do any harm.
Not at all and I didn't wan't to imply that.
And it's in fact easier to explain the needed changes here than in the tiny "Summary" field in the wiki edit form ;)
Indeed it is! Philipp --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-packaging+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-packaging+help@opensuse.org
Le mardi 18 mars 2008, à 16:02 +0100, Michal Marek a écrit :
Philipp Thomas wrote:
* Vincent Untz (vuntz@novell.com) [20080318 13:41]:
Hi,
I found several errors on http://en.opensuse.org/SUSE_Package_Conventions/Desktop_Menu What is the process to fix them? I guess it's a bit more complex than just editing the wiki page?
AFAIK, it *is* as easy as editing the wiki page :)
But posting an explanation to the mailing list surely doesn't do any harm. And it's in fact easier to explain the needed changes here than in the tiny "Summary" field in the wiki edit form ;)
Cool, it's easier than what I expected then :-) Is there another place where the changes should be announced or is this list enough? Also, does it make sense to have some kind of ChangeLog for this document? It would help to know what has changed since the last time you checked it. Thanks, Vincent -- Les gens heureux ne sont pas pressés. --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-packaging+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-packaging+help@opensuse.org
Also, does it make sense to have some kind of ChangeLog for this document? It would help to know what has changed since the last time you checked it.
Well, there used to be changelog before moving SPC to wiki. I was thinking about a way how to enforce writing changelog even now, but I could not come up with any idea - writing the changelog does not work well with wiki and incomplete changelog is useless. I am afraid that diffs in wiki history will have to be enough - I have no idea how to make people write changelogs. Do you have any? Anyway, feel free to enhance SPC and many thanks for it :-) Anicka --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-packaging+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-packaging+help@opensuse.org
Le mardi 18 mars 2008, à 16:54 +0100, Anicka Bernathova a écrit :
Also, does it make sense to have some kind of ChangeLog for this document? It would help to know what has changed since the last time you checked it.
Well, there used to be changelog before moving SPC to wiki. I was thinking about a way how to enforce writing changelog even now, but I could not come up with any idea - writing the changelog does not work well with wiki and incomplete changelog is useless.
I am afraid that diffs in wiki history will have to be enough - I have no idea how to make people write changelogs. Do you have any?
I don't think hoping that everybody will think of updating the changelog would work. I know I could easily forget ;-) Maybe we could have a changelog page and someone responsible for watching all the relevant pages and making sure the changelog page gets updated when there's a change? (I could even volunteer for this if people think it's useful) Vincent -- Les gens heureux ne sont pas pressés. --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-packaging+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-packaging+help@opensuse.org
Maybe we could have a changelog page and someone responsible for watching all the relevant pages and making sure the changelog page gets updated when there's a change?
(I could even volunteer for this if people think it's useful)
Changelog might be useful but I do not think it really pays off - the effort of the changelog-monkey might be bigger then the gain. Anicka --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-packaging+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-packaging+help@opensuse.org
participants (4)
-
Anicka Bernathova -
Michal Marek -
Philipp Thomas -
Vincent Untz