1 <?xml version='1.0' encoding='utf-8'?>
2 <!-- -*- DocBook -*- -->
3 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
4 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
5 <!ENTITY % versiondata SYSTEM "version.xml"> %versiondata;
9 <title>The Debian Menu sub-policy</title>
15 <firstname>Chris</firstname><surname>Waters</surname>
20 <firstname>Joey</firstname><surname>Hess</surname>
25 <firstname>Joost</firstname><surname>Witteveen</surname>
29 <othername>The Debian Policy mailing List</othername>
30 <email>debian-policy@lists.debian.org</email>
34 <releaseinfo>version &version;</releaseinfo>
35 <pubdate>&date;</pubdate>
39 This manual describes the policy requirements for the Menu system
40 used in the Debian distribution. This document is part of the
41 policy package for Debian.
47 <holder>Software in the Public Interest, Inc.</holder>
52 This manual is free software; you may redistribute it and/or modify
53 it under the terms of the GNU General Public License as published by
54 the Free Software Foundation; either version 2, or (at your option)
58 This is distributed in the hope that it will be useful, but
59 <emphasis>without any warranty</emphasis>; without even the implied
60 warranty of merchantability or fitness for a particular purpose.
61 See the GNU General Public License for more details.
64 A copy of the GNU General Public License is available as
65 <literal>/usr/doc/copyright/GPL</literal> in the Debian distribution
66 or on the World Wide Web at <ulink
67 url="http://www.gnu.org/copyleft/gpl.html">The GNU General Public
68 Licence</ulink>. You can also obtain it by writing to the Free
69 Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
76 <title>About this document</title>
78 This document is distributed as the <literal>menu-policy</literal>
79 files in the Debian package <systemitem role="package"><ulink
80 url="http://packages.debian.org/debian-policy">debian-policy</ulink></systemitem>.
81 It is also available from the Debian web mirrors at <literal><ulink
82 url="http://www.debian.org/doc/packaging-manuals/menu-policy/">/doc/packaging-manuals/menu-policy/</ulink></literal>.
85 This document has been extracted and separated from the
86 <emphasis>Menu</emphasis> package to:
88 <orderedlist numeration="arabic">
91 Increase the visibility of the Menu sub policy
96 Reduce the coupling between policy and implementation. If this
97 separation is not made, every time we want to change menu
98 policy, we have to arrange to get the maintainer to release a
99 new version of the package, even if the package has not
100 otherwise changed. It also involves yet another layer, making
101 the policy changes that much harder to implement.
106 The <ulink url="mailto:debian-policy@lists.debian.org">debian-policy
107 mailing list</ulink> has taken responsibility for the contents of
108 this document, with the <emphasis>Menu</emphasis> package
109 maintainer's responsible for packaging administrivia only.
114 <title>Menu Structure</title>
117 If you have a package which doesn't fit within the existing menu
118 hierarchy, please bring it up on the debian-devel mailing list. If
119 you have other proposals for changing the menu hierarchy, or making
120 other changes to menu policy, please bring it up on debian-policy.
124 <title>Preferred menu structure</title>
127 Here is the authoritative list of Debian's menu structure.
128 Packages must be placed in leaf sections.
133 <term>Applications</term>
140 <term>Applications/Accessibility</term>
143 Tools to aid people with disabilities or for machines
144 lacking usual input devices.
147 Examples: gok, yasr, dasher.
152 <term>Applications/Amateur Radio</term>
155 Anything relating to HAM radio.
158 Examples: baken, hamsoft, twlog
163 <term>Applications/Data Management</term>
166 Interactive database programs, collection managers,
167 address books, bibliography tools, etc.
170 gaby, alexandria, mdbtools
175 <term>Applications/Editors</term>
178 Editors, other than office word processors, for
179 text-based information.
182 Examples: ksubtile, nano, hexedit
187 <term>Applications/Education</term>
190 Educational and training softwares.
193 Examples: gtypist, gcompris, quiz
198 <term>Applications/Emulators</term>
201 Software that allows you to run non-native software or
202 more than one OS at a time.
205 Examples: wine, dosemu, qemu
210 <term>Applications/File Management</term>
213 Tools for file management, archiving, searching,
214 CD/DVD burning, backup, etc.
217 Examples: file-roller, mc, baobab
222 <term>Applications/Graphics</term>
225 2D and 3D graphics manipulation software.
228 Examples: gimp, inkscape, imagemagick
233 <term>Applications/Mobile Devices</term>
236 Software that allows you to interface with mobile
237 devices (phones, PDAs, etc.).
240 Examples: kandy, gnokii, gnome-pilot
245 <term>Applications/Network</term>
248 Network related software. This is a three-level
249 section, do not put entries directly here.
253 <term>Applications/Network/Communication</term>
256 Mail, USENET news, chat, instant messaging, IP
257 telephony, video conferencing software, etc.
260 Examples: xchat, gaim, mutt
265 <term>Applications/Network/File Transfer</term>
268 File transfer software such as download
269 managers, FTP clients, P2P clients, etc.
272 Examples: amule, gftp, d4x
277 <term>Applications/Network/Monitoring</term>
280 Network monitoring software
283 Examples: gip, ettercap, iptstate
288 <term>Applications/Network/Web Browsing</term>
291 Web browsers, tools for offline browsing, etc.
294 Examples: elinks, epiphany-browser, webhttrack
299 <term>Applications/Network/Web News</term>
302 Web feed (RSS, Atom, etc.) and podcast aggregators.
305 Examples: akregator, kitty, liferea
313 <term>Applications/Office</term>
316 Office suites, word processors, spreadsheets, CRM,
317 ERP, financial sofware, etc.
320 Examples: openoffice.org, tinyerp-client, gnucash
325 <term>Applications/Programming</term>
328 IDEs, debuggers, etc.
331 Examples: anjuta, gdb, eclipse
336 <term>Applications/Project Management</term>
339 Timetable managers, group task trackers, bug tracking
343 Examples: planner, bugzilla, gnotime
348 <term>Applications/Science</term>
351 Scientific and engineering-related software.
355 <term>Applications/Science/Astronomy</term>
358 Astronomy-related software.
361 Examples: celestia, spacechart, stellarium
366 <term>Applications/Science/Biology</term>
369 Biology-related software.
372 Examples: arb, ncbi-tools-x11, seaview
377 <term>Applications/Science/Chemistry</term>
380 Chemistry-related software.
383 Examples: chemtool, kalzium, xdrawchem
388 <term>Applications/Science/Data Analysis</term>
391 Software designed for processing, extracting,
392 and presenting generic scientific data.
395 Examples: fityk, ygraph, mn-fit
400 <term>Applications/Science/Electronics</term>
403 Circuit design tools, simulators and assemblers
404 for microprocessors, etc
407 Examples: geda, gnucap, tkgate
412 <term>Applications/Science/Engineering</term>
415 CAD, UML tools, diagram-drawing and other
416 engineering-related software.
419 Examples: tcm, dia, qcad
424 <term>Applications/Science/Geoscience</term>
427 Geoscience-related software.
430 Examples: earth3d, qgis, therion
435 <term>Applications/Science/Mathematics</term>
438 Mathematics-related software.
441 Examples: gcalctool, snappea, xeukleides
446 <term>Applications/Science/Medicine</term>
449 Medicine-related software.
452 Examples: mssstest, gnumed-client, xmedcon
457 <term>Applications/Science/Physics</term>
460 Physics-related software.
463 Examples: kxterm, ifrit, paw
468 <term>Applications/Science/Social</term>
471 Social sciences-related software.
474 Examples: gnomesword, hanzim, bibletime
482 <term>Applications/Shells</term>
485 Various shells to be used inside a terminal emulator.
488 Examples: bash, ksh, zsh
493 <term>Applications/Sound</term>
496 Sound players, editors, and rippers/recorders.
499 Examples: beep-media-player, grip, audacity
504 <term>Applications/System</term>
507 System related software.
511 <term>Applications/System/Administration</term>
514 Administrative and system configuration
515 utilities, also tools for personal user
519 Examples: gnome-control-center,
520 configure-debian, gksu
525 <term>Applications/System/Hardware</term>
528 Tools for manipulating specific hardware,
529 especially non-standard laptop hardware.
532 Examples: toshutils, nvclock-gtk, nvtv
537 <term>Applications/System/Language Environment</term>
540 This section is reserved for language-env as a
546 <term>Applications/System/Monitoring</term>
549 System information and monitoring tools, log
553 Examples: top, hal-device-manager, gtkdiskfree
558 <term>Applications/System/Package Management</term>
561 Package managers and related tools.
564 Examples: aptitude, deborphan, smartpm
569 <term>Applications/System/Security</term>
572 Security, cryptography and privacy related
573 software, antiviruses, tools to track and report
577 Examples: gpgkeys, bastille, avscan
585 <term>Applications/Terminal Emulators</term>
588 Graphical terminal emulators.
591 Examples: xterm, gnome-terminal, rxvt
596 <term>Applications/Text</term>
599 Text oriented tools like dictionaries, OCR,
600 translation, text analysis software, etc.
603 Examples: kdrill, stardict, turkey
608 <term>Applications/TV and Radio</term>
611 TV-in, TV-out, FM radio, teletext browsers, etc.
614 Examples: gradio, gatos, alevt
619 <term>Applications/Viewers</term>
622 Software for viewing images, documents and other
626 Examples: gqview, evince, gthumb
631 <term>Applications/Video</term>
634 Video players, editors, and rippers/recorders.
637 Examples: istanbul, totem, kino
642 <term>Applications/Web Development</term>
645 Software for web site editing, web programming, and
649 Examples: bluefish, screem, gphpedit
661 Games and recreations
665 <term>Games/Action</term>
668 Games that involve a lot of action and require fast
672 Examples: xsoldier, supertux, xmoto
677 <term>Games/Adventure</term>
680 Role playing and adventure games, interactive movies
684 Examples: beneath-a-steel-sky, egoboo, kq
689 <term>Games/Blocks</term>
692 Tetris-like games involving falling blocks.
695 Examples: crack-attack, frozen-bubble, netris
700 <term>Games/Board</term>
703 Games played on a board.
706 Examples: phalanx, xshogi, xboard
711 <term>Games/Card</term>
714 Games involving a deck of cards.
717 Examples: pysol, ace-of-penguins, xpat2
722 <term>Games/Puzzles</term>
725 Tests of ingenuity and logic.
728 Examples: xmpuzzles, sgt-puzzles, enigma
733 <term>Games/Simulation</term>
736 Simulations of the real world in all detail and
740 Examples: flightgear, torcs
745 <term>Games/Strategy</term>
748 Games involving long-term strategic thinking.
751 Examples: wesnoth, widelands, netpanzer
756 <term>Games/Tools</term>
759 Server browsers, configurators, editors, and other
760 game-related tools that are not games themselves.
763 Examples: xqf, crystalspace
768 <term>Games/Toys</term>
771 Amusements, eye-candy, entertaining demos, screen
772 hacks (screensavers), etc.
775 Examples: xdesktopwaves, xphoon, xpenguins
787 programs that provide user documentation
790 Examples: debian-reference, apt-howto, dhelp
799 Programs that affect the whole screen.
803 <term>Screen/Saving</term>
806 Tools for blanking the screen. Entries of screen
807 hacks and configuration GUIs should go to other
808 appropriate sections.
811 Examples: xscreensaver, xlockmore
816 <term>Screen/Locking</term>
819 Tools for locking the screen.
822 Examples: xscreensaver, xlockmore
831 <term>Window Managers</term>
837 Examples: fluxbox, metacity, waimea
843 <term>FVWM Modules</term>
846 FVWM-based window manager modules. As only modules related
847 to the running window-manager are displayed, do not create
848 subsections for specific window-managers.
851 Examples: fvwm, fvwm-gnome, fvwm95
857 <term>Window Maker</term>
860 This section is reserved for wmaker as a special case.
863 All wmaker specific entries must go here.