debian_debian-policy/menu-policy.sgml

<!doctype debiandoc system [
<!-- include version information so we don't have to hard code it
     within the document -->
<!entity % versiondata SYSTEM "version.ent"> %versiondata;
]>
<debiandoc>

  <!--
  The debian-policy mailing list has taken responsibility for the
  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>
      </author>
      <author>
	<name>Joey Hess</name> 
      </author>
      <author>
	<name>Joost Witteveen</name> 
      </author>
      <author>
	<name>The Debian Policy mailing List</name>
	<email>debian-policy@lists.debian.org</email>
      </author>
      <version>version &version;, &date;</version>

      <abstract>
	This manual describes the policy requirements for the Menu
	system used in the Debian distribution. This
	document is part of the policy package for Debian.
      </abstract>

      <copyright>
	<copyrightsummary>
	  Copyright &copy; 1999 Software in the Public Interest, Inc.
	</copyrightsummary>
	<p>
	  This manual is free software; you may redistribute it and/or
	  modify it under the terms of the GNU General Public License
	  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>
	  A copy of the GNU General Public License is available as
	  <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="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>
	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>Increase the visibility of the Menu sub policy</p>
	  </item>
	  <item>
	    <p>
	      Reduce the coupling between policy and
	      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
	      changed. It also involves yet another layer, making the
	      policy changes that much harder to implement.</p>
	  </item>
	</enumlist>
      </p>
    </chapt>

    <chapt>
      <heading>Menu Structure</heading>
      <p>
	If you have a package which doesn't fit within the existing
	menu hierarchy, please bring it up on the debian-devel mailing
	list.  If you have other proposals for changing the menu
	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. Packages must be placed in leaf sections.
 	</p>
	<p><taglist>
	    <tag>Applications</tag>
	    <item>
	      <p>Normal applications</p>
	      <p><taglist>
		  <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>Editors, other than office word processors, for 
                       text-based information.</p>
                    <p>Examples: ksubtile, nano, hexedit</p>
		  </item>
		  <tag>Applications/Education</tag>
		  <item>
		    <p>Educational and training softwares.</p>
                    <p>Examples: gtypist, gcompris, quiz</p>
		  </item>
		  <tag>Applications/Emulators</tag>
		  <item>
                    <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>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>2D and 3D graphics manipulation software.</p>
                    <p>Examples: gimp, inkscape, imagemagick</p>
		  </item>
                  <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>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>
	      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>
              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: -->