]> git.donarmstrong.com Git - debian/debian-policy.git/commitdiff
Substantial updates to the menu structure
authorRuss Allbery <rra@debian.org>
Wed, 4 Jul 2007 07:01:20 +0000 (07:01 +0000)
committerRuss Allbery <rra@debian.org>
Wed, 4 Jul 2007 07:01:20 +0000 (07:01 +0000)
Substantial updates to the menu structure from Bill Allombert.
Resolves Bug#361418.

git-archimport-id: rra@debian.org--lenny/debian-policy--devel--3.7--patch-3

debian/changelog
menu-policy.sgml
upgrading-checklist.html

index 47c71dcef8565c37bed9243260ab05b426fe2789..f938920902ecd6e9c3f8dab8df89b842f795a14b 100644 (file)
@@ -4,8 +4,10 @@ debian-policy (3.7.3.0) UNRELEASED; urgency=low
     to Nicolas François and Marc Brockschmidt                (Closes: #382612).
   * Bug fix: "Please add 'local' to list of supra-POSIX features that
     /bin/sh can be expected to offer". Also add test -a/-o binary logical
-    operators and change references from POSIX to SUSv3      (Closes: #294962)
-
+    operators and change references from POSIX to SUSv3      (Closes: #294962).
+  * Bug fix: "[Proposal] new Debian menu structure", thanks to Bill
+    Allombert                                                (Closes: #361418).
+  
  --
 
 debian-policy (3.7.2.2) unstable; urgency=low
index c2a2ec63bf628da0c3aca99850ec71001f62329b..673955806a7a32e7c9cd2fc101a681289522d283 100644 (file)
        <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>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>Amateur Radio</tag>
+                  <item>
+                    <p>Anything relating to HAM radio.</p>
+                    <p>Examples: baken, hamsoft, twlog</p>
+                  </item> 
+                  <tag>Data Management</tag>
+                  <item>
+                    <p>Interactive database programs, collection managers,
+                       address books, bibliography tools, etc.</p>
+                    <p>gaby, alexandria, mdbtools</p>
+                  </item>
                  <tag>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>Education</tag>
                  <item>
-                   <p>educational and training programs</p>
+                   <p>Educational and training softwares.</p>
+                    <p>Examples: gtypist, gcompris, quiz</p>
                  </item>
                  <tag>Emulators</tag>
                  <item>
-                   <p>wine, dosemu, etc.</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>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>Graphics</tag>
                  <item>
-                   <p>image manipulation</p>
-                 </item>
-                 <tag>Hamradio</tag>
-                 <item>
-                   <p>anything relating to ham radio</p>
-                 </item>
-                 <tag>Math</tag>
-                 <item>
-                   <p>math related programs</p>
-                 </item>
-                 <tag>Net</tag>
-                 <item>
-                   <p>network programs that don't fit elsewhere</p>
+                    <p>2D and 3D graphics manipulation software.</p>
+                    <p>Examples: gimp, inkscape, imagemagick</p>
                  </item>
+                  <tag>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>Network</tag>
+                  <item>
+                    Network related software. This is a three-level
+                    section, do not put entries directly here.
+                    <taglist>
+                    <tag>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>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>Monitoring</tag>
+                    <item>
+                       <p>Network monitoring software</p>
+                       <p>Examples: gip, ettercap, iptstate</p>
+                    </item>
+                    <tag>Web Browsing</tag>
+                    <item>
+                       <p>Web browsers, tools for offline browsing, etc.</p>
+                       <p>Examples: elinks, epiphany-browser, webhttrack</p>
+                    </item>
+                    <tag>Web News</tag>
+                    <item>
+                      <p>Web feed (RSS, Atom, etc.) and podcast aggregators.
+                      </p>
+                      <p>Examples: akregator, kitty, liferea</p>
+                    </item>
+                    </taglist>
+                  </item>
+                  <tag>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>Programming</tag>
                  <item>
-                   <p>debuggers, etc.</p>
-                 </item>
-                 <tag>Science</tag>                                           
-                 <item>                                                       
-                   <p>scientific programs</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>Project Management</tag>
+                  <item>
+                    <p>Timetable managers, group task trackers,
+                    bug tracking software, etc.</p>
+                    <p>Examples: planner, bugzilla, gnotime</p>
+                  </item>
+                  <tag>Science</tag>
+                  <item>
+                  Scientific and engineering-related software.
+                  <taglist>
+                    <tag>Astronomy</tag>
+                    <item>
+                      <p>Astronomy-related software.</p>
+                      <p>Examples: celestia, spacechart, stellarium</p>
+                    </item>
+                    <tag>Biology</tag>
+                    <item>
+                      <p>Biology-related software.</p>
+                      <p>Examples: arb, ncbi-tools-x11, seaview</p>
+                    </item>
+                    <tag>Chemistry</tag>
+                    <item>
+                      <p>Chemistry-related software.</p>
+                      <p>Examples: chemtool, kalzium, xdrawchem</p>
+                    </item>
+                    <tag>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>Electronics</tag>
+                    <item>
+                      <p>Circuit design tools, simulators and
+                         assemblers for microprocessors, etc</p>
+                      <p>Examples: geda, gnucap, tkgate</p>
+                    </item>
+                    <tag>Engineering</tag>
+                    <item>
+                      <p>CAD, UML tools, diagram-drawing and
+                         other engineering-related software.</p>
+                      <p>Examples: tcm, dia, qcad</p>
+                    </item>
+                    <tag>Geoscience</tag>
+                    <item>
+                      <p>Geoscience-related software.</p>
+                      <p>Examples: earth3d, qgis, therion</p>
+                    </item>
+                    <tag>Mathematics</tag>
+                    <item>
+                      <p>Mathematics-related software.</p>
+                      <p>Examples: gcalctool, snappea, xeukleides</p>
+                    </item>
+                    <tag>Medicine</tag>
+                    <item>
+                      <p>Medicine-related software.</p>
+                      <p>Examples: mssstest, gnumed-client, xmedcon</p>
+                    </item>
+                    <tag>Physics</tag>
+                    <item>
+                      <p>Physics-related software.</p>
+                      <p>Examples: kxterm, ifrit, paw</p>
+                    </item>
+                    <tag>Social</tag>
+                    <item>
+                      <p>Social sciences-related software.</p>
+                      <p>Examples: gnomesword, hanzim, bibletime</p>
+                    </item>
+                  </taglist>
+                  </item>
+                  <tag>Shells</tag>
+                  <item>
+                    <p>Various shells to be used inside a terminal emulator.</p>
+                    <p>Examples: bash, ksh, zsh</p>
+                  </item>
+                  <tag>Sound</tag>
+                  <item>
+                    <p>Sound players, editors, and rippers/recorders.</p>
+                    <p>Examples: beep-media-player, grip, audacity</p>
+                  </item>
+                  <tag>System</tag>
+                  <item>
+                    System related software.
+                  <taglist>
+                    <tag>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>Hardware</tag>
+                    <item>
+                      <p>Tools for manipulating specific hardware,
+                         especially non-standard laptop hardware.</p>
+                      <p>Examples: toshutils, nvclock-gtk, nvtv</p>
+                    </item>
+                    <tag>Language Environment</tag>
+                    <item>
+                      <p>This section is reserved for language-env as a
+                         special case.</p>
+                    </item>
+                    <tag>Monitoring</tag>
+                    <item>
+                      <p>System information and monitoring tools, log viewers,
+                         etc.</p>
+                      <p>Examples: top, hal-device-manager, gtkdiskfree</p>
+                    </item>
+                    <tag>Package Management</tag>
+                    <item>
+                      <p>Package managers and related tools.</p>
+                      <p>Examples: aptitude, deborphan, smartpm</p>
+                    </item>
+                    <tag>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>Terminal Emulators</tag>
+                  <item>
+                    <p>Graphical terminal emulators.</p>
+                    <p>Examples: xterm, gnome-terminal, rxvt</p>
+                  </item>
+                  <tag>Text</tag>
+                  <item>
+                    <p>Text oriented tools like dictionaries, OCR,
+                       translation, text analysis software, etc.</p>
+                    <p>Examples: kdrill, stardict, turkey</p>
+                  </item>
+                  <tag>TV and Radio</tag>
+                  <item>
+                    <p>TV-in, TV-out, FM radio, teletext browsers, etc.</p>
+                    <p>Examples: gradio, gatos, alevt</p>
+                  </item>
+                  <tag>Viewers</tag>
+                  <item>
+                    <p>Software for viewing images, documents
+                       and other (non-video) media.</p>
+                    <p>Examples: gqview, evince, gthumb</p>
+                  </item>
+                  <tag>Video</tag>
+                  <item>
+                    <p>Video players, editors, and rippers/recorders.</p>
+                    <p>Examples: istanbul, totem, kino</p>
+                  </item>
+                  <tag>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>Simulation</tag>
-                 <item>
-                   <p>Simulations of the real world (Flight
-                     Simulators, for example)</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>Action</tag>
+              <item>
+                <p>Games that involve a lot of action
+                   and require fast reflexes.</p>
+                <p>Examples: xsoldier, supertux, xmoto</p>
+              </item>
+              <tag>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>Blocks</tag>
+              <item>
+                <p>Tetris-like games involving falling blocks.</p>
+                <p>Examples: crack-attack, frozen-bubble, netris</p>
+              </item>
+              <tag>Board</tag>
+              <item>
+                <p>Games played on a board.</p>
+                <p>Examples: phalanx, xshogi, xboard</p>
+              </item>
+              <tag>Card</tag>
+              <item>
+                <p>Games involving a deck of cards.</p>
+                <p>Examples: pysol, ace-of-penguins, xpat2</p>
+              </item>
+              <tag>Puzzles</tag>
+              <item>
+                <p>Tests of ingenuity and logic.</p>
+                <p>Examples: xmpuzzles, sgt-puzzles, enigma</p>
+              </item>
+              <tag>Simulation</tag>
+              <item>
+                <p>Simulations of the real world
+                   in all detail and complexity.</p>
+                <p>Examples: flightgear, torcs</p>
+              </item>
+              <tag>Strategy</tag>
+              <item>
+                <p>Games involving long-term strategic thinking.</p>
+                <p>Examples: wesnoth, widelands, netpanzer</p>
+              </item>
+              <tag>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>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>
-                 <tag>Modules</tag>
-                 <item>
-                   <p>window manager modules</p>
-                 </item>
-               </taglist>
-             </p>
-           </item>
-           <tag>XShells</tag>
-           <item>
-             <p>xterm and its brethren</p>
-           </item>
+            <tag>Screen</tag>
+            <item>
+              Programs that affect the whole screen.
+              <taglist>
+              <tag>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, [fillme]</p>
+              </item>
+              <tag>Locking</tag>
+              <item>
+                <p>Tools for locking the screen.</p>
+                <p>Examples: xscreensaver, xlockmore, [fillme]</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>
index 1748b49133b7bd5aa4b95b13f2069996a0cfd120..9d2582428b770687da807cb1a4e49e1166022389 100644 (file)
@@ -59,6 +59,10 @@ picking your way through this list.
      * Scripts may assume that /bin/sh supports local (at a basic level)
        and that its test builtin (if any) supports -a and -o binary
        logical operators.                                        [10.4]
+     * Substantial reorganization and renaming of sections in the Debian
+       menu structure.  Packages with menu entries should be reviewed to
+       see if the menu section has been renamed or if one of the new
+       sections would be more appropriate.                       [menu policy]
 3.7.2.2                        Oct 2006
      * Maintainer scripts must not be world writeable (up from a
        should to a must)                                         [6.1]