summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'xml/htdocs/proj/en/glep/glep-0016.html')
-rw-r--r--xml/htdocs/proj/en/glep/glep-0016.html273
1 files changed, 273 insertions, 0 deletions
diff --git a/xml/htdocs/proj/en/glep/glep-0016.html b/xml/htdocs/proj/en/glep/glep-0016.html
new file mode 100644
index 00000000..9a056b82
--- /dev/null
+++ b/xml/htdocs/proj/en/glep/glep-0016.html
@@ -0,0 +1,273 @@
+<?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">
+
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+ <meta name="generator" content="Docutils 0.4: 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="http://www.gentoo.org/proj/en/glep/glep-0016.txt">GLEP Source</a></b>]
+</td></tr></table>
+<table class="rfc2822 docutils 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.cgi/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-0002.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">
+<p class="topic-title first"><a id="contents" 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">
+<h1><a class="toc-backref" href="#id29" id="definitions" name="definitions">Definitions</a></h1>
+<blockquote>
+<dl class="docutils">
+<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">
+<h1><a class="toc-backref" href="#id30" id="abstract" 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">
+<h1><a class="toc-backref" href="#id31" id="status" name="status">Status</a></h1>
+<p>Timed out (and now subsumed by the gentoo-desktop top-level project)</p>
+</div>
+<div class="section">
+<h1><a class="toc-backref" href="#id32" id="motivation" 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">
+<h1><a class="toc-backref" href="#id33" id="rationale" 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">
+<h1><a class="toc-backref" href="#id34" id="specification" 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">
+<h1><a class="toc-backref" href="#id35" id="implementation-status" 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">
+<h1><a class="toc-backref" href="#id36" id="credits" name="credits">Credits</a></h1>
+<p>Based on suggestions from former discussions on the gentoo bugzilla,
+mailinglists and forums.</p>
+</div>
+<div class="section">
+<h1><a class="toc-backref" href="#id37" id="references" name="references">References</a></h1>
+<table class="docutils 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="docutils 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="docutils 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="docutils 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="docutils 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="docutils 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="docutils 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="docutils 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="docutils 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="docutils 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="docutils 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="docutils 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="docutils 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="docutils 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">
+<h1><a class="toc-backref" href="#id38" id="copyright" name="copyright">Copyright</a></h1>
+<p>This document has been placed in the public domain.</p>
+</div>
+
+</div>
+<div class="footer">
+<hr class="footer" />
+<a class="reference" href="glep-0016.txt">View document source</a>.
+Generated on: 2007-10-13 13:39 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>
+