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