[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

[menus] add missing categories, examples from George's spec



Hi,

Fills in more Categories and some examples for using Categories and
OnlyShowIn that George had in his original document.

Havoc

Index: draft/menu-spec.sgml
===================================================================
RCS file: /home/freedesktop/web/content/standards/menu/draft/menu-spec.sgml,v
retrieving revision 1.12
diff -u -p -u -r1.12 menu-spec.sgml
--- draft/menu-spec.sgml	16 Dec 2002 03:20:56 -0000	1.12
+++ draft/menu-spec.sgml	16 Dec 2002 03:41:53 -0000
@@ -250,6 +250,39 @@ entries</ulink>: <varname>Categories</va
       linkend="onlyshowin-registry"> enumerates the strings to use for
       some common environments.
     </para>
+    <sect2 id="desktop-entry-extensions-examples">
+      <title>Examples of using <varname>Categories</varname> and <varname>OnlyShowIn</varname></title>
+      <para>
+        A desktop entry for a Qt-based image viewer might contain 
+        this <varname>Categories</varname> line:
+        <informalexample>
+          <programlisting>
+            Categories=Application;QT;Graphics;RasterGraphics;Viewer;
+          </programlisting>
+        </informalexample>
+      </para>
+      <para>
+        A desktop entry for Octave, a command-line mathematics program (which
+        would also have the field <literal>Terminal=true</literal>), might have:
+        <informalexample>
+          <programlisting>
+            Categories=Application;ConsoleOnly;Math;
+          </programlisting>
+        </informalexample>
+      </para>
+      <para>
+        A desktop entry for a GNOME-specific calculator program
+        that should only appear in GNOME might have:
+        <informalexample>
+          <programlisting>
+            Categories=Application;GNOME;Utility;
+            OnlyShowIn=GNOME;
+          </programlisting>
+        </informalexample>
+        Note that the <varname>OnlyShowIn</varname> field is a
+        <emphasis>list</emphasis> and thus ends in a semicolon.
+      </para>
+    </sect2>
   </sect1>
   <sect1 id="menu-file-format">
     <title>Format of menu files</title>
@@ -1064,7 +1097,6 @@ entries</ulink>: <varname>Categories</va
           </thead>
           <tbody>
             <row>
-              
               <entry>Legacy</entry> 
               <entry>Keyword that must be added to menu
               entries merged from legacy locations. May not actually exist in a
@@ -1073,8 +1105,8 @@ entries</ulink>: <varname>Categories</va
               &lt;AppDir&gt;, its desktop entries should be labeled "Legacy"
               only if the &lt;LegacyDir&gt; appears later in the file than the
               &lt;AppDir&gt;.</entry>
-            </row><row>
 
+            </row><row>
               <entry>Core</entry>
               <entry>Important application, core to the desktop such as a filemanager or a help browser</entry>
 
@@ -1087,6 +1119,14 @@ entries</ulink>: <varname>Categories</va
               <entry>An application that is primarily an icon for the "system tray" or "notification area" (apps that open a normal window and just happen to have a tray icon as well should not list this category)</entry>
 
             </row><row>
+              <entry>Screensaver</entry>
+              <entry>A screensaver (launching this desktop entry should activate the screensaver)</entry>
+
+            </row><row>
+              <entry>TerminalEmulator</entry>
+              <entry>A terminal emulator application.</entry>
+
+            </row><row>
               <entry>Development</entry>
               <entry>An application for development</entry>
 
@@ -1148,12 +1188,11 @@ entries</ulink>: <varname>Categories</va
 
             </row><row>
               <entry>System</entry>
-              <entry>System application</entry>
+              <entry>System application, "System Tools" such as say a log viewer or network monitor.</entry>
 
             </row><row>
               <entry>SystemSetup</entry>
-              <entry>System setup application, hardware installation, hardware clock setup, kernel setup, etc..
-                (e.g. X server setup)
+              <entry>System setup application, hardware installation, hardware clock setup, kernel setup, X server setup, etc.; i.e. system configuration tools.
               </entry>
 
             </row><row>
@@ -1162,15 +1201,15 @@ entries</ulink>: <varname>Categories</va
 
             </row><row>
               <entry>Utility</entry>
-              <entry>Small utility application</entry>
+              <entry>Small utility application, "Accessories"</entry>
 
             </row><row>
               <entry>Settings</entry>
-              <entry>Desktop settings applications (not system setting application, those should be System;SystemSetup)</entry>
+              <entry>Desktop settings applications (not system settings application, those should be System;SystemSetup;)</entry>
 
             </row><row>
               <entry>AdvancedSettings</entry>
-              <entry>Advanced desktop settings</entry>
+              <entry>Advanced desktop settings.</entry>
 
             </row><row>
               <entry>Accessibility</entry>
@@ -1186,7 +1225,7 @@ entries</ulink>: <varname>Categories</va
 
             </row><row>
               <entry>Monitor</entry>
-              <entry>Monitor application/applet for some resource</entry>
+              <entry>Monitor application/applet that monitors some resource or activity.</entry>
 
             </row><row>
               <entry>AudioVideo</entry>
@@ -1197,6 +1236,10 @@ entries</ulink>: <varname>Categories</va
               <entry>A simple amusement</entry>
 
             </row><row>
+              <entry>Emulator</entry>
+              <entry>Emulator of another platform, such as a DOS emulator.</entry>
+
+            </row><row>
               <entry>Game</entry>
               <entry>A game</entry>
 
@@ -1223,6 +1266,81 @@ entries</ulink>: <varname>Categories</va
             </row><row>
               <entry>PlatformGame</entry>
               <entry>Platform style game</entry>
+
+            </row><row>
+              <entry>PuzzleGame</entry>
+              <entry>Puzzle game</entry>
+
+            </row><row>
+              <entry>SportsGame</entry>
+              <entry>Sports game</entry>
+
+            </row><row>
+              <entry>StrategyGame</entry>
+              <entry>Strategy game</entry>
+
+            </row><row>
+              <entry>BlocksGame</entry>
+              <entry>Falling blocks game</entry>
+
+            </row><row>
+              <entry>Education</entry>
+              <entry>Educational software</entry>
+
+            </row><row>
+              <entry>Math</entry>
+              <entry>Math software</entry>
+
+            </row><row>
+              <entry>Astronomy</entry>
+              <entry>Astronomy software</entry>
+
+            </row><row>
+              <entry>Physics</entry>
+              <entry>Physics software</entry>
+
+            </row><row>
+              <entry>Chemistry</entry>
+              <entry>Chemistry software</entry>
+
+            </row><row>
+              <entry>Science</entry>
+              <entry>Scientific software</entry>
+
+            </row><row>
+              <entry>HamRadio</entry>
+              <entry>HAM radio software</entry>
+
+            </row><row>
+              <entry>KDE</entry>
+              <entry>Application based on KDE libraries.</entry>
+
+            </row><row>
+              <entry>GNOME</entry>
+              <entry>Application based on GNOME libraries.</entry>
+
+            </row><row>
+              <entry>GTK</entry>
+              <entry>Application based on GTK+ libraries (may also have GNOME category).</entry>
+
+            </row><row>
+              <entry>QT</entry>
+              <entry>Application based on Qt libraries (may also have KDE category).</entry>
+
+            </row><row>
+              <entry>Motif</entry>
+              <entry>Application based on Motif libraries.</entry>
+
+            </row><row>
+              <entry>ConsoleOnly</entry>
+              <entry>Application that only works inside a terminal (text-based or command line application).</entry>
+
+            </row><row>
+              <entry>Shell</entry>
+              <entry>A shell (an actual specific shell such as
+              <filename>bash</filename> or <filename>tcsh</filename>, not a
+              TerminalEmulator).</entry>
+
             </row>
           </tbody>
         </tgroup>





[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]