en/glep/glep-0016.html

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!--
This HTML is auto-generated.  DO NOT EDIT THIS FILE!  If you are writing a new
PEP, see http://www.python.org/peps/pep-0001.html for instructions and links
to templates.  DO NOT USE THIS HTML FILE AS YOUR TEMPLATE!
-->
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta name="generator" content="Docutils 0.3.3: http://docutils.sourceforge.net/" />
  <title>GLEP 16 -- Gentoo Menu System</title>
  <link rel="stylesheet" href="tools/glep.css" type="text/css" />
</head>
<body bgcolor="white">
<table class="navigation" cellpadding="0" cellspacing="0"
       width="100%" border="0">
<tr><td class="navicon" width="150" height="35">
<a href="http://www.gentoo.org/" title="Gentoo Linux Home Page">
<img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
 border="0" width="150" height="35" /></a></td>
<td class="textlinks" align="left">
[<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>]
[<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>]
[<b><a href="./glep-0016.txt">GLEP Source</a></b>]
</td></tr></table>
<div class="document">
<table class="rfc2822 field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">16</td>
</tr>
<tr class="field"><th class="field-name">Title:</th><td class="field-body">Gentoo Menu System</td>
</tr>
<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.7</td>
</tr>
<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs/xml/htdocs/proj/en/glep/glep-0016.txt?cvsroot=gentoo">2004/11/11 21:33:13</a></td>
</tr>
<tr class="field"><th class="field-name">Author:</th><td class="field-body">Heinrich Wendel &lt;lanius&#32;&#97;t&#32;gentoo.org&gt;,</td>
</tr>
<tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td>
</tr>
<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
</tr>
<tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0012.html">text/x-rst</a></td>
</tr>
<tr class="field"><th class="field-name">Created:</th><td class="field-body">09-Sep-2003</td>
</tr>
<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">04-Oct-2003, 11-Dec-2003, 13-Dec-2003, 4-May-2004, 11-Nov-2004</td>
</tr>
</tbody>
</table>
<hr />
<div class="contents topic" id="contents">
<p class="topic-title first"><a name="contents">Contents</a></p>
<ul class="simple">
<li><a class="reference" href="#definitions" id="id29" name="id29">Definitions</a></li>
<li><a class="reference" href="#abstract" id="id30" name="id30">Abstract</a></li>
<li><a class="reference" href="#status" id="id31" name="id31">Status</a></li>
<li><a class="reference" href="#motivation" id="id32" name="id32">Motivation</a></li>
<li><a class="reference" href="#rationale" id="id33" name="id33">Rationale</a></li>
<li><a class="reference" href="#specification" id="id34" name="id34">Specification</a></li>
<li><a class="reference" href="#implementation-status" id="id35" name="id35">Implementation / Status</a></li>
<li><a class="reference" href="#credits" id="id36" name="id36">Credits</a></li>
<li><a class="reference" href="#references" id="id37" name="id37">References</a></li>
<li><a class="reference" href="#copyright" id="id38" name="id38">Copyright</a></li>
</ul>
</div>
<div class="section" id="definitions">
<h1><a class="toc-backref" href="#id29" name="definitions">Definitions</a></h1>
<blockquote>
<dl>
<dt><em>APP</em></dt>
<dd>A graphical application that should be listed in the menus.</dd>
<dt><em>WM</em></dt>
<dd>A program containing a menu manager (i.e. a program that can display a menu, e.g. a windowmanager).</dd>
</dl>
</blockquote>
</div>
<div class="section" id="abstract">
<h1><a class="toc-backref" href="#id30" name="abstract">Abstract</a></h1>
<p>This GLEP handles a proposal for the following two goals:</p>
<ul class="simple">
<li>Create a common menu layout, which would be independent of the WM.
This point is quite important for those people who use more than one WM.</li>
<li>Provide a common way to add applications to the menus.</li>
</ul>
</div>
<div class="section" id="status">
<h1><a class="toc-backref" href="#id31" name="status">Status</a></h1>
<p>Timed out (and now subsumed by the gentoo-desktop top-level project)</p>
</div>
<div class="section" id="motivation">
<h1><a class="toc-backref" href="#id32" name="motivation">Motivation</a></h1>
<p>GNOME, KDE, Fluxbox, to name only a few, have all their own ways of handling
menus. There have been several requests <a class="footnote-reference" href="#id15" id="id1" name="id1">[1]</a> <a class="footnote-reference" href="#id16" id="id2" name="id2">[2]</a> <a class="footnote-reference" href="#id17" id="id3" name="id3">[3]</a> <a class="footnote-reference" href="#id18" id="id4" name="id4">[4]</a> <a class="footnote-reference" href="#id19" id="id5" name="id5">[5]</a> <a class="footnote-reference" href="#id20" id="id6" name="id6">[6]</a> from
users to streamline these menus. Furthermore there are several bug reports
about applications not having a menu entry <a class="footnote-reference" href="#id21" id="id7" name="id7">[7]</a>, but since there is not
standard way to create such an entry, they are just sitting around in
bugzilla.</p>
</div>
<div class="section" id="rationale">
<h1><a class="toc-backref" href="#id33" name="rationale">Rationale</a></h1>
<p>The idea of a common menu system is not new to the Linux world, every big
distribution (Debian, Mandrake, RedHat, Suse) has such a system. The big DE's,
KDE and GNOME, with the help of freedesktop.org <a class="footnote-reference" href="#id22" id="id8" name="id8">[8]</a>, are also trying to
implement one standard. That will most likely happen in GNOME 2.6 and KDE 3.2
(Currently they are only implementing different versions of the
desktop-entry-spec, but interpreting it in an incompatible way).  But there
are still many other WM's that currently don't support these specs.  So we are
trying to base our work on the specifications GNOME and KDE are going to use.
(These are no official standards but evolving specifications). This has the
following advantages:</p>
<ul class="simple">
<li>follow specified standards</li>
<li>i18n support</li>
<li>provide the necessary flexibility and modularity</li>
<li>integrate with small changes to our ebuildtree.</li>
<li>support for per system and per user menus</li>
</ul>
</div>
<div class="section" id="specification">
<h1><a class="toc-backref" href="#id34" name="specification">Specification</a></h1>
<p>We are trying to follow these specifications:</p>
<ul class="simple">
<li>Desktop Entry Specification <a class="footnote-reference" href="#id23" id="id9" name="id9">[9]</a></li>
<li>Menu Specification <a class="footnote-reference" href="#id24" id="id10" name="id10">[10]</a></li>
<li>Icon Theme Specification <a class="footnote-reference" href="#id25" id="id11" name="id11">[11]</a></li>
</ul>
<p>There are two libraries that offer an API to these specifications:</p>
<ul class="simple">
<li>PyXDG <a class="footnote-reference" href="#id26" id="id12" name="id12">[12]</a> (written in python)</li>
<li>Desktop File Utils <a class="footnote-reference" href="#id27" id="id13" name="id13">[13]</a> (written in C)</li>
</ul>
<p>Our goal is to patch the WM's with the help of these libraries to support the
specifications. APP's then only have to install a .desktop entry <a class="footnote-reference" href="#id23" id="id14" name="id14">[9]</a> and
optionally an icon and will be listed in all menus. This installation could
easily be done by two portage commands (domenu, doicon).</p>
</div>
<div class="section" id="implementation-status">
<h1><a class="toc-backref" href="#id35" name="implementation-status">Implementation / Status</a></h1>
<p>This GLEP exists for a long time now, still it is not accepted. I will outline
the current status:</p>
<ul class="simple">
<li>KDE 3.2 (x86) supports this specification</li>
<li>GNOME 2.6 (~x86) support this specification</li>
<li>domenu[<a class="reference" href="#id26">12</a>] has to be included in portage to be used by the ebuilds to
install a desktop entry</li>
<li>Somebody needs to write patches for the other WM's:</li>
</ul>
<p>We should focus on adding support to the following WM's first:</p>
<ul class="simple">
<li>xfce, blackblox / fluxbox / openbox / waimea / kahakai, icewm</li>
<li>fvwm, windowmaker, enlightment, afterstep</li>
</ul>
<p>The following are not so important, but support some kind of applications 
menu:</p>
<ul class="simple">
<li>aewm / aewm++ / evilwm / windowlab / oroborus, amiwm, ctwm, flwm</li>
<li>golem, larswm, pekwm, plwm, pwm, qvwm, selectwm, treewm, trwm</li>
<li>vtwm, xpde</li>
</ul>
</div>
<div class="section" id="credits">
<h1><a class="toc-backref" href="#id36" name="credits">Credits</a></h1>
<p>Based on suggestions from former discussions on the gentoo bugzilla,
mailinglists and forums.</p>
</div>
<div class="section" id="references">
<h1><a class="toc-backref" href="#id37" name="references">References</a></h1>
<table class="footnote" frame="void" id="id15" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id1" name="id15">[1]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=5510">http://bugs.gentoo.org/show_bug.cgi?id=5510</a></td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id16" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id2" name="id16">[2]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=10429">http://bugs.gentoo.org/show_bug.cgi?id=10429</a></td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id17" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id3" name="id17">[3]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=4884">http://bugs.gentoo.org/show_bug.cgi?id=4884</a></td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id18" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id4" name="id18">[4]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=25797">http://bugs.gentoo.org/show_bug.cgi?id=25797</a></td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id19" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id5" name="id19">[5]</a></td><td><a class="reference" href="http://forums.gentoo.org/viewtopic.php?t=66754">http://forums.gentoo.org/viewtopic.php?t=66754</a></td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id20" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id6" name="id20">[6]</a></td><td><a class="reference" href="http://forums.gentoo.org/viewtopic.php?p=263106#263106">http://forums.gentoo.org/viewtopic.php?p=263106#263106</a></td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id21" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id7" name="id21">[7]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=25756">http://bugs.gentoo.org/show_bug.cgi?id=25756</a></td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id22" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id8" name="id22">[8]</a></td><td><a class="reference" href="http://www.freedesktop.org">http://www.freedesktop.org</a></td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id23" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a name="id23">[9]</a></td><td><em>(<a class="fn-backref" href="#id9">1</a>, <a class="fn-backref" href="#id14">2</a>)</em> Desktop Entry Specification
[<a class="reference" href="http://www.freedesktop.org/standards/desktop-entry-spec/0.9.4/">http://www.freedesktop.org/standards/desktop-entry-spec/0.9.4/</a>]</td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id24" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id10" name="id24">[10]</a></td><td>Menu Specification
[<a class="reference" href="http://www.freedesktop.org/standards/menu-spec/0.8/">http://www.freedesktop.org/standards/menu-spec/0.8/</a>]</td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id25" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id11" name="id25">[11]</a></td><td>Icon Theme Specification
[<a class="reference" href="http://www.freedesktop.org/standards/icon-theme-spec/0.7/">http://www.freedesktop.org/standards/icon-theme-spec/0.7/</a>]</td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id26" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id12" name="id26">[12]</a></td><td>PyXDG
[<a class="reference" href="http://www.freedesktop.org/software/pyxdg">http://www.freedesktop.org/software/pyxdg</a>]</td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id27" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id13" name="id27">[13]</a></td><td>Desktop File Utils
[<a class="reference" href="http://www.freedesktop.org/software/desktop-file-utils">http://www.freedesktop.org/software/desktop-file-utils</a>]</td></tr>
</tbody>
</table>
<table class="footnote" frame="void" id="id28" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a name="id28">[14]</a></td><td>domenu
[<a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=25756">http://bugs.gentoo.org/show_bug.cgi?id=25756</a>]</td></tr>
</tbody>
</table>
</div>
<div class="section" id="copyright">
<h1><a class="toc-backref" href="#id38" name="copyright">Copyright</a></h1>
<p>This document has been placed in the public domain.</p>
</div>
</div>

<hr class="footer" />
<div class="footer">
<a class="reference" href="glep-0016.txt">View document source</a>.
Generated on: 2004-11-11 21:26 UTC.
Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
</div>
</body>
</html>

1	liquidx	1.1	<?xml version="1.0" encoding="utf-8" ?>
2			<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3			<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4			<!--
5			This HTML is auto-generated. DO NOT EDIT THIS FILE! If you are writing a new
6			PEP, see http://www.python.org/peps/pep-0001.html for instructions and links
7			to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE!
8			-->
9			<head>
10			<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11	g2boojum	1.5	<meta name="generator" content="Docutils 0.3.3: http://docutils.sourceforge.net/" />
12	liquidx	1.1	<title>GLEP 16 -- Gentoo Menu System</title>
13			<link rel="stylesheet" href="tools/glep.css" type="text/css" />
14			</head>
15			<body bgcolor="white">
16			<table class="navigation" cellpadding="0" cellspacing="0"
17			width="100%" border="0">
18			<tr><td class="navicon" width="150" height="35">
19			<a href="http://www.gentoo.org/" title="Gentoo Linux Home Page">
20			<img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
21			border="0" width="150" height="35" /></a></td>
22			<td class="textlinks" align="left">
23			[<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>]
24			[<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>]
25	g2boojum	1.5	[<b><a href="./glep-0016.txt">GLEP Source</a></b>]
26	liquidx	1.1	</td></tr></table>
27			<div class="document">
28			<table class="rfc2822 field-list" frame="void" rules="none">
29			<col class="field-name" />
30			<col class="field-body" />
31			<tbody valign="top">
32			<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">16</td>
33			</tr>
34			<tr class="field"><th class="field-name">Title:</th><td class="field-body">Gentoo Menu System</td>
35			</tr>
36	g2boojum	1.6	<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.7</td>
37	liquidx	1.1	</tr>
38	g2boojum	1.6	<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs/xml/htdocs/proj/en/glep/glep-0016.txt?cvsroot=gentoo">2004/11/11 21:33:13</a></td>
39	liquidx	1.1	</tr>
40			<tr class="field"><th class="field-name">Author:</th><td class="field-body">Heinrich Wendel <lanius at gentoo.org>,</td>
41			</tr>
42	g2boojum	1.6	<tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td>
43	liquidx	1.1	</tr>
44			<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
45			</tr>
46	g2boojum	1.5	<tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0012.html">text/x-rst</a></td>
47	liquidx	1.1	</tr>
48			<tr class="field"><th class="field-name">Created:</th><td class="field-body">09-Sep-2003</td>
49			</tr>
50	g2boojum	1.5	<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">04-Oct-2003, 11-Dec-2003, 13-Dec-2003, 4-May-2004, 11-Nov-2004</td>
51	liquidx	1.1	</tr>
52			</tbody>
53			</table>
54			<hr />
55			<div class="contents topic" id="contents">
56	g2boojum	1.5	<p class="topic-title first"><a name="contents">Contents</a></p>
57	liquidx	1.1	<ul class="simple">
58	g2boojum	1.4	<li><a class="reference" href="#definitions" id="id29" name="id29">Definitions</a></li>
59			<li><a class="reference" href="#abstract" id="id30" name="id30">Abstract</a></li>
60	g2boojum	1.5	<li><a class="reference" href="#status" id="id31" name="id31">Status</a></li>
61			<li><a class="reference" href="#motivation" id="id32" name="id32">Motivation</a></li>
62			<li><a class="reference" href="#rationale" id="id33" name="id33">Rationale</a></li>
63			<li><a class="reference" href="#specification" id="id34" name="id34">Specification</a></li>
64			<li><a class="reference" href="#implementation-status" id="id35" name="id35">Implementation / Status</a></li>
65			<li><a class="reference" href="#credits" id="id36" name="id36">Credits</a></li>
66			<li><a class="reference" href="#references" id="id37" name="id37">References</a></li>
67			<li><a class="reference" href="#copyright" id="id38" name="id38">Copyright</a></li>
68	liquidx	1.1	</ul>
69			</div>
70			<div class="section" id="definitions">
71	g2boojum	1.4	<h1><a class="toc-backref" href="#id29" name="definitions">Definitions</a></h1>
72	liquidx	1.1	<blockquote>
73			<dl>
74			<dt><em>APP</em></dt>
75			<dd>A graphical application that should be listed in the menus.</dd>
76			<dt><em>WM</em></dt>
77			<dd>A program containing a menu manager (i.e. a program that can display a menu, e.g. a windowmanager).</dd>
78			</dl>
79			</blockquote>
80			</div>
81			<div class="section" id="abstract">
82	g2boojum	1.4	<h1><a class="toc-backref" href="#id30" name="abstract">Abstract</a></h1>
83	liquidx	1.1	<p>This GLEP handles a proposal for the following two goals:</p>
84			<ul class="simple">
85			<li>Create a common menu layout, which would be independent of the WM.
86	g2boojum	1.2	This point is quite important for those people who use more than one WM.</li>
87	liquidx	1.1	<li>Provide a common way to add applications to the menus.</li>
88			</ul>
89			</div>
90	g2boojum	1.5	<div class="section" id="status">
91			<h1><a class="toc-backref" href="#id31" name="status">Status</a></h1>
92			<p>Timed out (and now subsumed by the gentoo-desktop top-level project)</p>
93			</div>
94	liquidx	1.1	<div class="section" id="motivation">
95	g2boojum	1.5	<h1><a class="toc-backref" href="#id32" name="motivation">Motivation</a></h1>
96	liquidx	1.1	<p>GNOME, KDE, Fluxbox, to name only a few, have all their own ways of handling
97	g2boojum	1.2	menus. There have been several requests <a class="footnote-reference" href="#id15" id="id1" name="id1">[1]</a> <a class="footnote-reference" href="#id16" id="id2" name="id2">[2]</a> <a class="footnote-reference" href="#id17" id="id3" name="id3">[3]</a> <a class="footnote-reference" href="#id18" id="id4" name="id4">[4]</a> <a class="footnote-reference" href="#id19" id="id5" name="id5">[5]</a> <a class="footnote-reference" href="#id20" id="id6" name="id6">[6]</a> from
98	liquidx	1.1	users to streamline these menus. Furthermore there are several bug reports
99	g2boojum	1.2	about applications not having a menu entry <a class="footnote-reference" href="#id21" id="id7" name="id7">[7]</a>, but since there is not
100	liquidx	1.1	standard way to create such an entry, they are just sitting around in
101			bugzilla.</p>
102			</div>
103			<div class="section" id="rationale">
104	g2boojum	1.5	<h1><a class="toc-backref" href="#id33" name="rationale">Rationale</a></h1>
105	liquidx	1.1	<p>The idea of a common menu system is not new to the Linux world, every big
106			distribution (Debian, Mandrake, RedHat, Suse) has such a system. The big DE's,
107	g2boojum	1.2	KDE and GNOME, with the help of freedesktop.org <a class="footnote-reference" href="#id22" id="id8" name="id8">[8]</a>, are also trying to
108	liquidx	1.1	implement one standard. That will most likely happen in GNOME 2.6 and KDE 3.2
109			(Currently they are only implementing different versions of the
110			desktop-entry-spec, but interpreting it in an incompatible way). But there
111	g2boojum	1.2	are still many other WM's that currently don't support these specs. So we are
112			trying to base our work on the specifications GNOME and KDE are going to use.
113			(These are no official standards but evolving specifications). This has the
114			following advantages:</p>
115	liquidx	1.1	<ul class="simple">
116			<li>follow specified standards</li>
117			<li>i18n support</li>
118			<li>provide the necessary flexibility and modularity</li>
119			<li>integrate with small changes to our ebuildtree.</li>
120			<li>support for per system and per user menus</li>
121			</ul>
122			</div>
123			<div class="section" id="specification">
124	g2boojum	1.5	<h1><a class="toc-backref" href="#id34" name="specification">Specification</a></h1>
125	g2boojum	1.2	<p>We are trying to follow these specifications:</p>
126			<ul class="simple">
127			<li>Desktop Entry Specification <a class="footnote-reference" href="#id23" id="id9" name="id9">[9]</a></li>
128			<li>Menu Specification <a class="footnote-reference" href="#id24" id="id10" name="id10">[10]</a></li>
129			<li>Icon Theme Specification <a class="footnote-reference" href="#id25" id="id11" name="id11">[11]</a></li>
130			</ul>
131			<p>There are two libraries that offer an API to these specifications:</p>
132			<ul class="simple">
133			<li>PyXDG <a class="footnote-reference" href="#id26" id="id12" name="id12">[12]</a> (written in python)</li>
134			<li>Desktop File Utils <a class="footnote-reference" href="#id27" id="id13" name="id13">[13]</a> (written in C)</li>
135	liquidx	1.1	</ul>
136	g2boojum	1.2	<p>Our goal is to patch the WM's with the help of these libraries to support the
137			specifications. APP's then only have to install a .desktop entry <a class="footnote-reference" href="#id23" id="id14" name="id14">[9]</a> and
138	g2boojum	1.3	optionally an icon and will be listed in all menus. This installation could
139	g2boojum	1.4	easily be done by two portage commands (domenu, doicon).</p>
140			</div>
141			<div class="section" id="implementation-status">
142	g2boojum	1.5	<h1><a class="toc-backref" href="#id35" name="implementation-status">Implementation / Status</a></h1>
143	g2boojum	1.4	<p>This GLEP exists for a long time now, still it is not accepted. I will outline
144			the current status:</p>
145			<ul class="simple">
146			<li>KDE 3.2 (x86) supports this specification</li>
147			<li>GNOME 2.6 (~x86) support this specification</li>
148			<li>domenu[<a class="reference" href="#id26">12</a>] has to be included in portage to be used by the ebuilds to
149			install a desktop entry</li>
150			<li>Somebody needs to write patches for the other WM's:</li>
151			</ul>
152			<p>We should focus on adding support to the following WM's first:</p>
153			<ul class="simple">
154			<li>xfce, blackblox / fluxbox / openbox / waimea / kahakai, icewm</li>
155			<li>fvwm, windowmaker, enlightment, afterstep</li>
156			</ul>
157			<p>The following are not so important, but support some kind of applications
158			menu:</p>
159			<ul class="simple">
160			<li>aewm / aewm++ / evilwm / windowlab / oroborus, amiwm, ctwm, flwm</li>
161			<li>golem, larswm, pekwm, plwm, pwm, qvwm, selectwm, treewm, trwm</li>
162			<li>vtwm, xpde</li>
163			</ul>
164	liquidx	1.1	</div>
165			<div class="section" id="credits">
166	g2boojum	1.5	<h1><a class="toc-backref" href="#id36" name="credits">Credits</a></h1>
167	g2boojum	1.2	<p>Based on suggestions from former discussions on the gentoo bugzilla,
168			mailinglists and forums.</p>
169	liquidx	1.1	</div>
170			<div class="section" id="references">
171	g2boojum	1.5	<h1><a class="toc-backref" href="#id37" name="references">References</a></h1>
172	g2boojum	1.2	<table class="footnote" frame="void" id="id15" rules="none">
173	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
174			<tbody valign="top">
175	g2boojum	1.2	<tr><td class="label"><a class="fn-backref" href="#id1" name="id15">[1]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=5510">http://bugs.gentoo.org/show_bug.cgi?id=5510</a></td></tr>
176	liquidx	1.1	</tbody>
177			</table>
178	g2boojum	1.2	<table class="footnote" frame="void" id="id16" rules="none">
179	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
180			<tbody valign="top">
181	g2boojum	1.2	<tr><td class="label"><a class="fn-backref" href="#id2" name="id16">[2]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=10429">http://bugs.gentoo.org/show_bug.cgi?id=10429</a></td></tr>
182	liquidx	1.1	</tbody>
183			</table>
184	g2boojum	1.2	<table class="footnote" frame="void" id="id17" rules="none">
185	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
186			<tbody valign="top">
187	g2boojum	1.2	<tr><td class="label"><a class="fn-backref" href="#id3" name="id17">[3]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=4884">http://bugs.gentoo.org/show_bug.cgi?id=4884</a></td></tr>
188	liquidx	1.1	</tbody>
189			</table>
190	g2boojum	1.2	<table class="footnote" frame="void" id="id18" rules="none">
191	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
192			<tbody valign="top">
193	g2boojum	1.2	<tr><td class="label"><a class="fn-backref" href="#id4" name="id18">[4]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=25797">http://bugs.gentoo.org/show_bug.cgi?id=25797</a></td></tr>
194	liquidx	1.1	</tbody>
195			</table>
196	g2boojum	1.2	<table class="footnote" frame="void" id="id19" rules="none">
197	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
198			<tbody valign="top">
199	g2boojum	1.2	<tr><td class="label"><a class="fn-backref" href="#id5" name="id19">[5]</a></td><td><a class="reference" href="http://forums.gentoo.org/viewtopic.php?t=66754">http://forums.gentoo.org/viewtopic.php?t=66754</a></td></tr>
200	liquidx	1.1	</tbody>
201			</table>
202	g2boojum	1.2	<table class="footnote" frame="void" id="id20" rules="none">
203	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
204			<tbody valign="top">
205	g2boojum	1.2	<tr><td class="label"><a class="fn-backref" href="#id6" name="id20">[6]</a></td><td><a class="reference" href="http://forums.gentoo.org/viewtopic.php?p=263106#263106">http://forums.gentoo.org/viewtopic.php?p=263106#263106</a></td></tr>
206	liquidx	1.1	</tbody>
207			</table>
208	g2boojum	1.2	<table class="footnote" frame="void" id="id21" rules="none">
209	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
210			<tbody valign="top">
211	g2boojum	1.2	<tr><td class="label"><a class="fn-backref" href="#id7" name="id21">[7]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=25756">http://bugs.gentoo.org/show_bug.cgi?id=25756</a></td></tr>
212	liquidx	1.1	</tbody>
213			</table>
214	g2boojum	1.2	<table class="footnote" frame="void" id="id22" rules="none">
215	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
216			<tbody valign="top">
217	g2boojum	1.2	<tr><td class="label"><a class="fn-backref" href="#id8" name="id22">[8]</a></td><td><a class="reference" href="http://www.freedesktop.org">http://www.freedesktop.org</a></td></tr>
218	liquidx	1.1	</tbody>
219			</table>
220	g2boojum	1.2	<table class="footnote" frame="void" id="id23" rules="none">
221	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
222			<tbody valign="top">
223	g2boojum	1.2	<tr><td class="label"><a name="id23">[9]</a></td><td><em>(<a class="fn-backref" href="#id9">1</a>, <a class="fn-backref" href="#id14">2</a>)</em> Desktop Entry Specification
224	liquidx	1.1	[<a class="reference" href="http://www.freedesktop.org/standards/desktop-entry-spec/0.9.4/">http://www.freedesktop.org/standards/desktop-entry-spec/0.9.4/</a>]</td></tr>
225			</tbody>
226			</table>
227	g2boojum	1.2	<table class="footnote" frame="void" id="id24" rules="none">
228	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
229			<tbody valign="top">
230	g2boojum	1.2	<tr><td class="label"><a class="fn-backref" href="#id10" name="id24">[10]</a></td><td>Menu Specification
231			[<a class="reference" href="http://www.freedesktop.org/standards/menu-spec/0.8/">http://www.freedesktop.org/standards/menu-spec/0.8/</a>]</td></tr>
232	liquidx	1.1	</tbody>
233			</table>
234	g2boojum	1.2	<table class="footnote" frame="void" id="id25" rules="none">
235	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
236			<tbody valign="top">
237	g2boojum	1.2	<tr><td class="label"><a class="fn-backref" href="#id11" name="id25">[11]</a></td><td>Icon Theme Specification
238	liquidx	1.1	[<a class="reference" href="http://www.freedesktop.org/standards/icon-theme-spec/0.7/">http://www.freedesktop.org/standards/icon-theme-spec/0.7/</a>]</td></tr>
239			</tbody>
240			</table>
241	g2boojum	1.2	<table class="footnote" frame="void" id="id26" rules="none">
242	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
243			<tbody valign="top">
244	g2boojum	1.2	<tr><td class="label"><a class="fn-backref" href="#id12" name="id26">[12]</a></td><td>PyXDG
245	g2boojum	1.3	[<a class="reference" href="http://www.freedesktop.org/software/pyxdg">http://www.freedesktop.org/software/pyxdg</a>]</td></tr>
246	liquidx	1.1	</tbody>
247			</table>
248	g2boojum	1.2	<table class="footnote" frame="void" id="id27" rules="none">
249	liquidx	1.1	<colgroup><col class="label" /><col /></colgroup>
250			<tbody valign="top">
251	g2boojum	1.2	<tr><td class="label"><a class="fn-backref" href="#id13" name="id27">[13]</a></td><td>Desktop File Utils
252			[<a class="reference" href="http://www.freedesktop.org/software/desktop-file-utils">http://www.freedesktop.org/software/desktop-file-utils</a>]</td></tr>
253	liquidx	1.1	</tbody>
254			</table>
255	g2boojum	1.4	<table class="footnote" frame="void" id="id28" rules="none">
256			<colgroup><col class="label" /><col /></colgroup>
257			<tbody valign="top">
258			<tr><td class="label"><a name="id28">[14]</a></td><td>domenu
259			[<a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=25756">http://bugs.gentoo.org/show_bug.cgi?id=25756</a>]</td></tr>
260			</tbody>
261			</table>
262	liquidx	1.1	</div>
263			<div class="section" id="copyright">
264	g2boojum	1.5	<h1><a class="toc-backref" href="#id38" name="copyright">Copyright</a></h1>
265	liquidx	1.1	<p>This document has been placed in the public domain.</p>
266			</div>
267			</div>
268
269	g2boojum	1.5	<hr class="footer" />
270	liquidx	1.1	<div class="footer">
271			<a class="reference" href="glep-0016.txt">View document source</a>.
272	g2boojum	1.6	Generated on: 2004-11-11 21:26 UTC.
273	liquidx	1.1	Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
274			</div>
275			</body>
276			</html>
277