menu-policy.sgml

   1 <!doctype debiandoc system [
   2 <!-- include version information so we don't have to hard code it
   3      within the document -->
   4 <!entity % versiondata SYSTEM "version.ent"> %versiondata;
   5 ]>
   6 <debiandoc>
   7   <!--
   8   Debian GNU/Linux Menu Sub-Policy Manual.
   9   Copyright (C)1999 ;
  10
  11   released under the terms of the GNU General Public License, version
  12   2 or (at your option) any later.
  13
  14   The debian-policy mailing list has taken responsibility for the
  15   contents of this document8, with the package maintainers responsible
  16   for packagingn adminstrivia only.
  17
  18   -->
  19
  20   <book>
  21     <titlepag>
  22       <title>The Debian Menu sub-policy</title>
  23       <author>
  24         <name>Chris Waters  </name>
  25         <email>xtifr@dsp.net</email>
  26       </author>
  27       <author>
  28         <name>Joey Hess</name>
  29         <email>joey@kitenet.net</email>
  30       </author>
  31       <author>
  32         <name>Joost Witteveen</name>
  33         <email>joostje@debian.org</email>
  34       </author>
  35       <author>
  36         <name>The Debian Policy mailing List</name>
  37         <email>debian-policy@lists.debian.org</email>
  38       </author>
  39       <version>version &version;, &date;</version>
  40
  41       <abstract>
  42         This manual describes the policy requirements for the Menu
  43         system used in the Debian GNU/Linux distribution. This
  44         document is part of the policy package for Debian. The policy
  45         package itself is maintained by a group of maintainers that
  46         have no editorial powers. At the moment, the list of
  47         maintainers is:
  48         <enumlist>
  49           <item>
  50             <p>Michael Alan Dorman <email>mdorman@debian.org</email></p>
  51           </item>
  52           <item>
  53             <p>Richard Braakman <email>dark@xs4all.nl</email></p>
  54           </item>
  55           <item>
  56             <p>Philip Hands <email>phil@hands.com</email></p>
  57           </item>
  58           <item>
  59             <p>Manoj Srivastava <email>srivasta@debian.org</email></p>
  60           </item>
  61         </enumlist>
  62       </abstract>
  63
  64
  65       <copyright>
  66         <copyrightsummary>
  67           Copyright &copy;1999 .
  68         </copyrightsummary>
  69         <p>
  70           This manual is free software; you may redistribute it and/or
  71           modify it under the terms of the GNU General Public License
  72           as published by the Free Software Foundation; either version
  73           2, or (at your option) any later version.
  74         </p>
  75
  76         <p>
  77           This is distributed in the hope that it will be useful, but
  78           <em>without any warranty</em>; without even the implied
  79           warranty of merchantability or fitness for a particular
  80           purpose.  See the GNU General Public License for more
  81           details.
  82           </p>
  83         <p>
  84           A copy of the GNU General Public License is available as
  85           <tt>/usr/doc/copyright/GPL</tt> in the Debian GNU/Linux
  86           distribution or on the World Wide Web at
  87           <url id="http://www.gnu.org/copyleft/gpl.html"
  88           name="&urlname">. You can also obtain it by writing to the
  89           Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  90           Boston, MA 02111-1307, USA.
  91         </p>
  92       </copyright>
  93     </titlepag>
  94
  95     <toc detail="sect">
  96     <chapt>
  97       <heading>About this document</heading>
  98       <p>
  99         The latest copy of this document can be found at
 100         <ftpsite>ftp.debian.org</ftpsite>
 101         <ftppath>/debian/doc/package-developer/menu_policy.txt</ftppath>
 102       </p>
 103       <p>
 104         This document has been extracted and separated from the
 105         <em>Menu</em> package to:<enumlist>
 106           <item>
 107             <p>Increase the visibility of the Menu sub policy</p>
 108           </item>
 109           <item>
 110             <p>
 111               Reduce the coupling between policy and
 112               implementation. If this separtion is not made, every
 113               time we want to change menu policy, we have to arrange
 114               to get the maintainer to release a new version of the
 115               package, even if the package has not otherwise
 116               changed. It also involves yet another layer, making the
 117               policy changes that much harder to implement.</p>
 118           </item>
 119         </enumlist>
 120       </p>
 121     </chapt>
 122     <chapt>
 123       <heading>Menu Structure</heading>
 124       <p>
 125         If you have a package which doesn't fit within the existing
 126         menu heirarchy, please bring it up on the debian-devel mailing
 127         list.  If you have other proposals for changing the menu
 128         heirarchy, or making other changes to menu policy, please
 129         bring it up on debian-policy.
 130       </p>
 131       <sect>
 132         <heading>Preferred menu structure</heading>
 133         <p>
 134           Here is the authoritative list of Debian's menu
 135           structure. Please do not put your packages into any other
 136           sections without asking for permission first!
 137         </p>
 138         <p><taglist>
 139             <tag>Apps</tag>
 140             <item>
 141               <p>normal applications</p>
 142               <p><taglist>
 143                   <tag>Databases</tag>
 144                   <item>
 145                     <p>interactive database programs</p>
 146                   </item>
 147                   <tag>Editors</tag>
 148                   <item>
 149                     <p>text editors, word processors</p>
 150                   </item>
 151                   <tag>Emulators</tag>
 152                   <item>
 153                     <p>wine, dosemu, etc.</p>
 154                   </item>
 155                   <tag>Graphics</tag>
 156                   <item>
 157                     <p>image manipulation</p>
 158                   </item>
 159                   <tag>Hamradio</tag>
 160                   <item>
 161                     <p>anything relating to ham radio</p>
 162                   </item>
 163                   <tag>Math</tag>
 164                   <item>
 165                     <p>math related programs</p>
 166                   </item>
 167                   <tag>Net</tag>
 168                   <item>
 169                     <p>network programs that don't fit elsewhere</p>
 170                   </item>
 171                   <tag>Programming</tag>
 172                   <item>
 173                     <p>debuggers, etc.</p>
 174                   </item>
 175                   <tag>Tools</tag>
 176                   <item>
 177                     <p>simple apps, like clocks, that perform only one task</p>
 178                   </item>
 179                   <tag>Technical</tag>
 180                   <item>
 181                     <p>technical stuff</p>
 182                   </item>
 183                   <tag>Text</tag>
 184                   <item>
 185                     <p>text oriented tools other than editors</p>
 186                   </item>
 187                   <tag>Shells</tag>
 188                   <item>
 189                     <p>bash, ksh, zsh, etc.</p>
 190                   </item>
 191                   <tag>Sound</tag>
 192                   <item>
 193                     <p>sound players and editors</p>
 194                   </item>
 195                   <tag>Viewers</tag>
 196                   <item>
 197                     <p>image viewers</p>
 198                   </item>
 199                   <tag>System</tag>
 200                   <item>
 201                     <p>system administration and monitoring tools</p>
 202                   </item>
 203                 </taglist>
 204               </p>
 205             </item>
 206             <tag>Games</tag>
 207             <item>
 208               <p>games and recreations</p>
 209               <p><taglist>
 210                   <tag>Adventure</tag>
 211                   <item>
 212                     <p>walk around virtual space, zork, MOO's, etc</p>
 213                   </item>
 214                   <tag>Arcade</tag>
 215                   <item>
 216                     <p>any game where reflexes count</p>
 217                   </item>
 218                   <tag>Board</tag>
 219                   <item>
 220                     <p>games played on a board</p>
 221                   </item>
 222                   <tag>Card</tag>
 223                   <item>
 224                     <p>games involving a deck of cards</p>
 225                   </item>
 226                   <tag>Puzzles</tag>
 227                   <item>
 228                     <p>tests of ingenuity and logic</p>
 229                   </item>
 230                   <tag>Sports</tag>
 231                   <item>
 232                     <p>games derived from "real world" sports</p>
 233                   </item>
 234                   <tag>Strategy</tag>
 235                   <item>
 236                     <p>games involving long term strategic thinking</p>
 237                   </item>
 238                   <tag>Tetris-like</tag>
 239                   <item>
 240                     <p>games involving falling blocks</p>
 241                   </item>
 242                   <tag>Toys</tag>
 243                   <item>
 244                     <p>amusements, eye-candy, etc.</p>
 245                   </item>
 246                 </taglist>
 247               </p>
 248             </item>
 249             <tag>Help</tag>
 250             <item>
 251               <p>programs that provide user documentation</p>
 252             </item>
 253             <tag>Screen</tag>
 254             <item>
 255               <p>programs that affect the whole screen</p>
 256               <p>
 257                 <taglist>
 258                   <tag>Lock</tag>
 259                   <item>
 260                     <p>programs to lock the screen</p>
 261                   </item>
 262                   <tag>Save</tag>
 263                   <item>
 264                     <p>screen savers</p>
 265                   </item>
 266                   <tag>Root-window</tag>
 267                   <item>
 268                     <p>things that fill the root window</p>
 269                   </item>
 270                 </taglist>
 271               </p>
 272             </item>
 273             <tag>WindowManagers</tag>
 274             <item>
 275               <p>X window managers</p>
 276               <p>
 277                 <taglist>
 278                   <tag>Modules></tag>
 279                   <item>
 280                     <p>window manager modules</p>
 281                   </item>
 282                 </taglist>
 283               </p>
 284             </item>
 285             <tag>XShells</tag>
 286             <item>
 287               <p>xterm and its brethern</p>
 288             </item>
 289           </taglist>
 290         </p>
 291       </sect>
 292     </chapt>
 293   </book>
 294 </debiandoc>
 295
 296
 297
 298
 299
 300