<!entity % versiondata SYSTEM "version.ent"> %versiondata;
]>
<debiandoc>
- <!--
- Debian GNU/Linux Menu Sub-Policy Manual.
- Copyright (C)1999 ;
-
- released under the terms of the GNU General Public License, version
- 2 or (at your option) any later.
+ <!--
The debian-policy mailing list has taken responsibility for the
- contents of this document8, with the package maintainers responsible
- for packagingn adminstrivia only.
-
+ contents of this document, with the package maintainers responsible
+ for packaging administrivia only.
-->
-
+
<book>
<titlepag>
<title>The Debian Menu sub-policy</title>
<author>
- <name>Chris Waters </name>
- <email>xtifr@dsp.net</email>
+ <name>Chris Waters</name>
</author>
<author>
<name>Joey Hess</name>
- <email>joey@kitenet.net</email>
</author>
<author>
<name>Joost Witteveen</name>
- <email>joostje@debian.org</email>
</author>
<author>
<name>The Debian Policy mailing List</name>
<abstract>
This manual describes the policy requirements for the Menu
- system used in the Debian GNU/Linux distribution. This
- document is part of the policy package for Debian. The policy
- package itself is maintained by a group of maintainers that
- have no editorial powers. At the moment, the list of
- maintainers is:
- <enumlist>
- <item>
- <p>Michael Alan Dorman <email>mdorman@debian.org</email></p>
- </item>
- <item>
- <p>Richard Braakman <email>dark@xs4all.nl</email></p>
- </item>
- <item>
- <p>Philip Hands <email>phil@hands.com</email></p>
- </item>
- <item>
- <p>Manoj Srivastava <email>srivasta@debian.org</email></p>
- </item>
- </enumlist>
+ system used in the Debian distribution. This
+ document is part of the policy package for Debian.
</abstract>
-
<copyright>
<copyrightsummary>
- Copyright ©1999 .
+ Copyright © 1999 Software in the Public Interest, Inc.
</copyrightsummary>
<p>
This manual is free software; you may redistribute it and/or
as published by the Free Software Foundation; either version
2, or (at your option) any later version.
</p>
-
<p>
This is distributed in the hope that it will be useful, but
<em>without any warranty</em>; without even the implied
warranty of merchantability or fitness for a particular
purpose. See the GNU General Public License for more
details.
- </p>
+ </p>
<p>
A copy of the GNU General Public License is available as
- <tt>/usr/doc/copyright/GPL</tt> in the Debian GNU/Linux
+ <tt>/usr/doc/copyright/GPL</tt> in the Debian
distribution or on the World Wide Web at
<url id="http://www.gnu.org/copyleft/gpl.html"
- name="&urlname">. You can also obtain it by writing to the
- Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- Boston, MA 02111-1307, USA.
+ name="The GNU General Public Licence">. You can also obtain it by writing to the
+ Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
+ Boston, MA 02110-1301, USA.
</p>
</copyright>
</titlepag>
<toc detail="sect">
<chapt>
<heading>About this document</heading>
+
<p>
- The latest copy of this document can be found at
- <ftpsite>ftp.debian.org</ftpsite>
- <ftppath>/debian/doc/package-developer/menu_policy.txt</ftppath>
+ This document is distributed as the <tt>menu-policy</tt> files
+ in the Debian package
+ <package><url name="debian-policy" id="http://packages.debian.org/debian-policy"></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>
+
<p>
This document has been extracted and separated from the
<em>Menu</em> package to:<enumlist>
<item>
<p>
Reduce the coupling between policy and
- implementation. If this separtion is not made, every
+ implementation. If this separation is not made, every
time we want to change menu policy, we have to arrange
to get the maintainer to release a new version of the
package, even if the package has not otherwise
</enumlist>
</p>
</chapt>
+
<chapt>
<heading>Menu Structure</heading>
<p>
If you have a package which doesn't fit within the existing
- menu heirarchy, please bring it up on the debian-devel mailing
+ menu hierarchy, please bring it up on the debian-devel mailing
list. If you have other proposals for changing the menu
- heirarchy, or making other changes to menu policy, please
+ hierarchy, or making other changes to menu policy, please
bring it up on debian-policy.
</p>
<sect>
<heading>Preferred menu structure</heading>
<p>
Here is the authoritative list of Debian's menu
- structure. Please do not put your packages into any other
- sections without asking for permission first!
- </p>
+ structure. Packages must be placed in leaf sections.
+ </p>
<p><taglist>
- <tag>Apps</tag>
+ <tag>Applications</tag>
<item>
- <p>normal applications</p>
+ <p>Normal applications</p>
<p><taglist>
- <tag>Databases</tag>
- <item>
- <p>interactive database programs</p>
- </item>
- <tag>Editors</tag>
+ <tag>Applications/Accessibility</tag>
+ <item>
+ <p>Tools to aid people with disabilities or for machines
+ lacking usual input devices.</p>
+ <p>Examples: gok, yasr, dasher.</p>
+ </item>
+ <tag>Applications/Amateur Radio</tag>
+ <item>
+ <p>Anything relating to HAM radio.</p>
+ <p>Examples: baken, hamsoft, twlog</p>
+ </item>
+ <tag>Applications/Data Management</tag>
+ <item>
+ <p>Interactive database programs, collection managers,
+ address books, bibliography tools, etc.</p>
+ <p>gaby, alexandria, mdbtools</p>
+ </item>
+ <tag>Applications/Editors</tag>
<item>
- <p>text editors, word processors</p>
+ <p>Editors, other than office word processors, for
+ text-based information.</p>
+ <p>Examples: ksubtile, nano, hexedit</p>
</item>
- <tag>Emulators</tag>
+ <tag>Applications/Education</tag>
<item>
- <p>wine, dosemu, etc.</p>
+ <p>Educational and training softwares.</p>
+ <p>Examples: gtypist, gcompris, quiz</p>
</item>
- <tag>Graphics</tag>
+ <tag>Applications/Emulators</tag>
<item>
- <p>image manipulation</p>
+ <p>Software that allows you to run non-native
+ software or more than one OS at a time.</p>
+ <p>Examples: wine, dosemu, qemu</p>
</item>
- <tag>Hammradio</tag>
+ <tag>Applications/File Management</tag>
+ <item>
+ <p>Tools for file management, archiving,
+ searching, CD/DVD burning, backup, etc.</p>
+ <p>Examples: file-roller, mc, baobab</p>
+ </item>
+ <tag>Applications/Graphics</tag>
<item>
- <p>anything relating to ham radio</p>
+ <p>2D and 3D graphics manipulation software.</p>
+ <p>Examples: gimp, inkscape, imagemagick</p>
</item>
- <tag>Math</tag>
+ <tag>Applications/Mobile Devices</tag>
+ <item>
+ <p>Software that allows you to interface with mobile
+ devices (phones, PDAs, etc.).</p>
+ <p>Examples: kandy, gnokii, gnome-pilot</p>
+ </item>
+ <tag>Applications/Network</tag>
+ <item>
+ Network related software. This is a three-level
+ section, do not put entries directly here.
+ <taglist>
+ <tag>Applications/Network/Communication</tag>
+ <item>
+ <p>Mail, USENET news, chat, instant messaging,
+ IP telephony, video conferencing software, etc.</p>
+ <p>Examples: xchat, gaim, mutt</p>
+ </item>
+ <tag>Applications/Network/File Transfer</tag>
+ <item>
+ <p>File transfer software such as download
+ managers, FTP clients, P2P clients, etc.</p>
+ <p>Examples: amule, gftp, d4x</p>
+ </item>
+ <tag>Applications/Network/Monitoring</tag>
+ <item>
+ <p>Network monitoring software</p>
+ <p>Examples: gip, ettercap, iptstate</p>
+ </item>
+ <tag>Applications/Network/Web Browsing</tag>
+ <item>
+ <p>Web browsers, tools for offline browsing, etc.</p>
+ <p>Examples: elinks, epiphany-browser, webhttrack</p>
+ </item>
+ <tag>Applications/Network/Web News</tag>
+ <item>
+ <p>Web feed (RSS, Atom, etc.) and podcast aggregators.
+ </p>
+ <p>Examples: akregator, kitty, liferea</p>
+ </item>
+ </taglist>
+ </item>
+ <tag>Applications/Office</tag>
+ <item>
+ <p>Office suites, word processors, spreadsheets,
+ CRM, ERP, financial sofware, etc.</p>
+ <p>Examples: openoffice.org, tinyerp-client, gnucash</p>
+ </item>
+ <tag>Applications/Programming</tag>
<item>
- <p>math related programs</p>
- </item>
- <tag>Net</tag>
- <item>
- <p>network programs that don't fit elsewhere</p>
- </item>
- <tag>Programming</tag>
- <item>
- <p>debuggers, etc.</p>
- </item>
- <tag>Tools</tag>
- <item>
- <p>simple apps, like clocks, that perform only one task</p>
- </item>
- <tag>Technical</tag>
- <item>
- <p>technical stuff</p>
- </item>
- <tag>Text</tag>
- <item>
- <p>text oriented tools other than editors</p>
- </item>
- <tag>Shells</tag>
- <item>
- <p>bash, ksh, zsh, etc.</p>
- </item>
- <tag>Sound</tag>
- <item>
- <p>sound players and editors</p>
- </item>
- <tag>Viewers</tag>
- <item>
- <p>image viewers</p>
- </item>
- <tag>System</tag>
- <item>
- <p>system administration and monitoring tools</p>
+ <p>IDEs, debuggers, etc.</p>
+ <p>Examples: anjuta, gdb, eclipse</p>
</item>
+ <tag>Applications/Project Management</tag>
+ <item>
+ <p>Timetable managers, group task trackers,
+ bug tracking software, etc.</p>
+ <p>Examples: planner, bugzilla, gnotime</p>
+ </item>
+ <tag>Applications/Science</tag>
+ <item>
+ Scientific and engineering-related software.
+ <taglist>
+ <tag>Applications/Science/Astronomy</tag>
+ <item>
+ <p>Astronomy-related software.</p>
+ <p>Examples: celestia, spacechart, stellarium</p>
+ </item>
+ <tag>Applications/Science/Biology</tag>
+ <item>
+ <p>Biology-related software.</p>
+ <p>Examples: arb, ncbi-tools-x11, seaview</p>
+ </item>
+ <tag>Applications/Science/Chemistry</tag>
+ <item>
+ <p>Chemistry-related software.</p>
+ <p>Examples: chemtool, kalzium, xdrawchem</p>
+ </item>
+ <tag>Applications/Science/Data Analysis</tag>
+ <item>
+ <p>Software designed for processing, extracting,
+ and presenting generic scientific data.</p>
+ <p>Examples: fityk, ygraph, mn-fit</p>
+ </item>
+ <tag>Applications/Science/Electronics</tag>
+ <item>
+ <p>Circuit design tools, simulators and
+ assemblers for microprocessors, etc</p>
+ <p>Examples: geda, gnucap, tkgate</p>
+ </item>
+ <tag>Applications/Science/Engineering</tag>
+ <item>
+ <p>CAD, UML tools, diagram-drawing and
+ other engineering-related software.</p>
+ <p>Examples: tcm, dia, qcad</p>
+ </item>
+ <tag>Applications/Science/Geoscience</tag>
+ <item>
+ <p>Geoscience-related software.</p>
+ <p>Examples: earth3d, qgis, therion</p>
+ </item>
+ <tag>Applications/Science/Mathematics</tag>
+ <item>
+ <p>Mathematics-related software.</p>
+ <p>Examples: gcalctool, snappea, xeukleides</p>
+ </item>
+ <tag>Applications/Science/Medicine</tag>
+ <item>
+ <p>Medicine-related software.</p>
+ <p>Examples: mssstest, gnumed-client, xmedcon</p>
+ </item>
+ <tag>Applications/Science/Physics</tag>
+ <item>
+ <p>Physics-related software.</p>
+ <p>Examples: kxterm, ifrit, paw</p>
+ </item>
+ <tag>Applications/Science/Social</tag>
+ <item>
+ <p>Social sciences-related software.</p>
+ <p>Examples: gnomesword, hanzim, bibletime</p>
+ </item>
+ </taglist>
+ </item>
+ <tag>Applications/Shells</tag>
+ <item>
+ <p>Various shells to be used inside a terminal emulator.</p>
+ <p>Examples: bash, ksh, zsh</p>
+ </item>
+ <tag>Applications/Sound</tag>
+ <item>
+ <p>Sound players, editors, and rippers/recorders.</p>
+ <p>Examples: beep-media-player, grip, audacity</p>
+ </item>
+ <tag>Applications/System</tag>
+ <item>
+ System related software.
+ <taglist>
+ <tag>Applications/System/Administration</tag>
+ <item>
+ <p>Administrative and system configuration utilities,
+ also tools for personal user settings.</p>
+ <p>Examples: gnome-control-center, configure-debian, gksu</p>
+ </item>
+ <tag>Applications/System/Hardware</tag>
+ <item>
+ <p>Tools for manipulating specific hardware,
+ especially non-standard laptop hardware.</p>
+ <p>Examples: toshutils, nvclock-gtk, nvtv</p>
+ </item>
+ <tag>Applications/System/Language Environment</tag>
+ <item>
+ <p>This section is reserved for language-env as a
+ special case.</p>
+ </item>
+ <tag>Applications/System/Monitoring</tag>
+ <item>
+ <p>System information and monitoring tools, log viewers,
+ etc.</p>
+ <p>Examples: top, hal-device-manager, gtkdiskfree</p>
+ </item>
+ <tag>Applications/System/Package Management</tag>
+ <item>
+ <p>Package managers and related tools.</p>
+ <p>Examples: aptitude, deborphan, smartpm</p>
+ </item>
+ <tag>Applications/System/Security</tag>
+ <item>
+ <p>Security, cryptography and privacy related software,
+ antiviruses, tools to track and report bugs, etc.</p>
+ <p>Examples: gpgkeys, bastille, avscan</p>
+ </item>
+ </taglist>
+ </item>
+ <tag>Applications/Terminal Emulators</tag>
+ <item>
+ <p>Graphical terminal emulators.</p>
+ <p>Examples: xterm, gnome-terminal, rxvt</p>
+ </item>
+ <tag>Applications/Text</tag>
+ <item>
+ <p>Text oriented tools like dictionaries, OCR,
+ translation, text analysis software, etc.</p>
+ <p>Examples: kdrill, stardict, turkey</p>
+ </item>
+ <tag>Applications/TV and Radio</tag>
+ <item>
+ <p>TV-in, TV-out, FM radio, teletext browsers, etc.</p>
+ <p>Examples: gradio, gatos, alevt</p>
+ </item>
+ <tag>Applications/Viewers</tag>
+ <item>
+ <p>Software for viewing images, documents
+ and other (non-video) media.</p>
+ <p>Examples: gqview, evince, gthumb</p>
+ </item>
+ <tag>Applications/Video</tag>
+ <item>
+ <p>Video players, editors, and rippers/recorders.</p>
+ <p>Examples: istanbul, totem, kino</p>
+ </item>
+ <tag>Applications/Web Development</tag>
+ <item>
+ <p>Software for web site editing, web
+ programming, and site administration.</p>
+ <p>Examples: bluefish, screem, gphpedit</p>
+ </item>
</taglist>
</p>
</item>
<tag>Games</tag>
<item>
- <p>games and recreations</p>
- <p><taglist>
- <tag>Adventure</tag>
- <item>
- <p>walk around virtual space, zork, MOO's, etc</p>
- </item>
- <tag>Arcade</tag>
- <item>
- <p>any game where reflexes count</p>
- </item>
- <tag>Board</tag>
- <item>
- <p>games played on a board</p>
- </item>
- <tag>Card</tag>
- <item>
- <p>games involving a deck of cards</p>
- </item>
- <tag>Puzzles</tag>
- <item>
- <p>tests of ingenuity and logic</p>
- </item>
- <tag>Sports</tag>
- <item>
- <p>games derived from "real world" sports</p>
- </item>
- <tag>Strategy</tag>
- <item>
- <p>games involving long term strategic thinking</p>
- </item>
- <tag>Tetris-like</tag>
- <item>
- <p>games involving falling blocks</p>
- </item>
- <tag>Toys</tag>
- <item>
- <p>amusements, eye-candy, etc.</p>
- </item>
- </taglist>
- </p>
+ Games and recreations
+ <taglist>
+ <tag>Games/Action</tag>
+ <item>
+ <p>Games that involve a lot of action
+ and require fast reflexes.</p>
+ <p>Examples: xsoldier, supertux, xmoto</p>
+ </item>
+ <tag>Games/Adventure</tag>
+ <item>
+ <p>Role playing and adventure games,
+ interactive movies and stories, etc.</p>
+ <p>Examples: beneath-a-steel-sky, egoboo, kq</p>
+ </item>
+ <tag>Games/Blocks</tag>
+ <item>
+ <p>Tetris-like games involving falling blocks.</p>
+ <p>Examples: crack-attack, frozen-bubble, netris</p>
+ </item>
+ <tag>Games/Board</tag>
+ <item>
+ <p>Games played on a board.</p>
+ <p>Examples: phalanx, xshogi, xboard</p>
+ </item>
+ <tag>Games/Card</tag>
+ <item>
+ <p>Games involving a deck of cards.</p>
+ <p>Examples: pysol, ace-of-penguins, xpat2</p>
+ </item>
+ <tag>Games/Puzzles</tag>
+ <item>
+ <p>Tests of ingenuity and logic.</p>
+ <p>Examples: xmpuzzles, sgt-puzzles, enigma</p>
+ </item>
+ <tag>Games/Simulation</tag>
+ <item>
+ <p>Simulations of the real world
+ in all detail and complexity.</p>
+ <p>Examples: flightgear, torcs</p>
+ </item>
+ <tag>Games/Strategy</tag>
+ <item>
+ <p>Games involving long-term strategic thinking.</p>
+ <p>Examples: wesnoth, widelands, netpanzer</p>
+ </item>
+ <tag>Games/Tools</tag>
+ <item>
+ <p>Server browsers, configurators, editors, and other
+ game-related tools that are not games themselves.</p>
+ <p>Examples: xqf, crystalspace</p>
+ </item>
+ <tag>Games/Toys</tag>
+ <item>
+ <p>Amusements, eye-candy, entertaining
+ demos, screen hacks (screensavers), etc.</p>
+ <p>Examples: xdesktopwaves, xphoon, xpenguins</p>
+ </item>
+ </taglist>
</item>
<tag>Help</tag>
<item>
<p>programs that provide user documentation</p>
+ <p>Examples: debian-reference, apt-howto, dhelp</p>
</item>
- <tag>Screen</tag>
- <item>
- <p>programs that affect the whole screen</p>
- <p>
- <taglist>
- <tag>Lock</tag>
- <item>
- <p>programs to lock the screen</p>
- </item>
- <tag>Save</tag>
- <item>
- <p>screen savers</p>
- </item>
- <tag>Root-window</tag>
- <item>
- <p>things that fill the root window</p>
- </item>
- </taglist>
- </p>
- </item>
- <tag>WindowManagers</tag>
- <item>
- <p>X window managers</p>
- <p>
- <taglist>
- <tagModules></tag>
- <item>
- <p>window manager modules</p>
- </item>
- </taglist>
- </p>
- </item>
- <tag>XShells</tag>
- <item>
- <p>xterm and its brethern</p>
- </item>
+ <tag>Screen</tag>
+ <item>
+ Programs that affect the whole screen.
+ <taglist>
+ <tag>Screen/Saving</tag>
+ <item>
+ <p>Tools for blanking the screen. Entries of screen hacks and
+ configuration GUIs should go to other appropriate sections.
+ </p>
+ <p>Examples: xscreensaver, xlockmore</p>
+ </item>
+ <tag>Screen/Locking</tag>
+ <item>
+ <p>Tools for locking the screen.</p>
+ <p>Examples: xscreensaver, xlockmore</p>
+ </item>
+ </taglist>
+ </item>
+ <tag>Window Managers</tag>
+ <item>
+ <p>X window managers.</p>
+ <p>Examples: fluxbox, metacity, waimea</p>
+ </item>
+ <tag>FVWM Modules</tag>
+ <item>
+ <p>FVWM-based window manager modules. As only modules related to
+ the running window-manager are displayed, do not create
+ subsections for specific window-managers.</p>
+ <p>Examples: fvwm, fvwm-gnome, fvwm95</p>
+ </item>
+ <tag>Window Maker</tag>
+ <item>
+ <p>This section is reserved for wmaker as a special case.</p>
+ <p>All wmaker specific entries must go here.</p>
+ </item>
</taglist>
</p>
</sect>
</chapt>
</book>
</debiandoc>
-
-
-
-
-
-
+<!-- Local variables: -->
+<!-- indent-tabs-mode: t -->
+<!-- End: -->
projects / debian / debian-policy.git / blobdiff