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