Charles Plessy <plessy@debian.org> (2014-02-14): > With the addition above, I call for seconds (patch attached). Markus, > please raise your hand if I was wrong to think that this addition > correctly addresses your comments. Since I know nothing about Multimedia handlers, and since I'm probably not going to learn today, I'm seconding the first part only, which looks good to me. Thanks to everyone involved. > diff --git a/policy.sgml b/policy.sgml > index dad8d23..43c93d3 100644 > --- a/policy.sgml > +++ b/policy.sgml > @@ -8054,38 +8054,75 @@ Reloading <var>description</var> configuration...done. > <heading>Menus</heading> > > <p> > - The Debian <tt>menu</tt> package provides a standard > - interface between packages providing applications and > - <em>menu programs</em> (either X window managers or > - text-based menu programs such as <prgn>pdmenu</prgn>). > + Packages shipping applications that comply with minimal requirements > + described below for integration with desktop environments should > + register these applications in the desktop menu, following the > + <em>FreeDesktop</em> standard, using text files called > + <em>desktop entries</em>. Their format is described in the > + <em>Desktop Entry Specification</em> at > + <url id="http://standards.freedesktop.org/desktop-entry-spec/latest/";> > + and complementary information can be found in the > + <em>Desktop Menu Specification</em> at > + <url id="http://standards.freedesktop.org/menu-spec/latest/";>. > </p> > > <p> > - All packages that provide applications that need not be > - passed any special command line arguments for normal > - operation should register a menu entry for those > - applications, so that users of the <tt>menu</tt> package > - will automatically get menu entries in their window > - managers, as well in shells like <tt>pdmenu</tt>. > + The desktop entry files are installed by the packages in the > + directory <file>/usr/share/applications</file> and the FreeDesktop > + menus are refreshed using <em>dpkg triggers</em>. It is therefore > + not necessary to depend on packages providing FreeDesktop menu > + systems. > </p> > > <p> > - Menu entries should follow the current menu policy. > + Entries displayed in the FreeDesktop menu should conform to the > + following minima for relevance and visual integration. > + > + <list> > + <item> > + Unless hidden by default, the desktop entry must point to a PNG > + or SVG icon with a transparent background, providing at least > + the 22×22 size, and preferably up to 64×64. The icon > + should be neutral enough to integrate well with the default icon > + themes. It is encouraged to ship the icon in the default > + <em>hicolor</em> icon theme directories, or to use an existing > + icon from the <em>hicolor</em> theme. > + </item> > + > + <item> > + If the menu entry is not useful in the general case as a > + standalone application, the desktop entry should set the > + <tt>NoDisplay</tt> key to <var>true</var>, so that it can be > + configured to be displayed only by those who need it. > + </item> > + > + <item> > + In doubt, the package maintainer should coordinate with the > + maintainers of menu implementations through the > + <em>debian-desktop</em> mailing list in order to avoid problems > + with categories or bad interactions with other icons. Especially > + for packages which are part of installation tasks, the contents > + of the <tt>NotShowIn</tt>/<tt>OnlyShowIn</tt> keys should be > + validated by the maintainers of the relevant environments. > + </item> > + </list> > </p> > > <p> > - The menu policy can be found in the <tt>menu-policy</tt> > - files in the <tt>debian-policy</tt> package. > - It is also available from the Debian web mirrors at > - <tt><url name="/doc/packaging-manuals/menu-policy/" > - id="http://www.debian.org/doc/packaging-manuals/menu-policy/";></tt>. > + Since the FreeDesktop menu is a cross-distribution standard, the > + desktop entries written for Debian should be forwarded upstream, > + where they will benefit to other users and are more likely to > + receive extra contributions such as translations. > </p> > > - <p> > - Please also refer to the <em>Debian Menu System</em> > - documentation that comes with the <package>menu</package> > - package for information about how to register your > - applications. > + <p> > + Packages can, to be compatible with Debian additions to some window > + managers that do not support the FreeDesktop standard, also provide a > + <em>Debian menu</em> file, following the <em>Debian menu policy</em>, > + which can be found in the <tt>menu-policy</tt> files in the > + <tt>debian-policy</tt> package. It is also available from the Debian > + web mirrors at <tt><url name="/doc/packaging-manuals/menu-policy/" > + id="http://www.debian.org/doc/packaging-manuals/menu-policy/";></tt>. > </p> > </sect> Seconded. Mraw, KiBi.
Attachment:
signature.asc
Description: Digital signature