~ubuntu-branches/debian/sid/menu/sid

« back to all changes in this revision

Viewing changes to doc/menufile.5

  • Committer: Bazaar Package Importer
  • Author(s): Bill Allombert
  • Date: 2005-05-24 10:34:47 UTC
  • mfrom: (1.1.2 hoary)
  • Revision ID: james.westby@ubuntu.com-20050524103447-9zu50so5d0nte3o9
Tags: 2.1.24
* The "head or tail" release 
* Fix .menus typo in menufile.5. Closes: #306564. Thanks Sean Finney.
* Add Vietnamese menu messages and menu sections translations.
  Thanks Clytie Siddall. Closes: #307450, #308953.
* Update Esperanto menu sections translation. Thanks MJ Ray.
* Add Esperanto menu messages translation. Thanks MJ Ray.
* Unfuzzy Norwegian Bokmål menu messages translation.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.\" -*- nroff -*-
2
 
.TH MENUFILE 5L "File Formats" "DEBIAN"
 
2
.TH MENUFILE 5 "File Formats" "DEBIAN"
3
3
.SH NAME
4
4
menufile \- entry in the Debian menu system
5
5
.SH SYNOPSIS
9
9
.PP
10
10
.B /usr/lib/menu/*
11
11
.PP
12
 
.B /usr/lib/menu/default/*
 
12
.B /usr/share/menu/default/*
13
13
.SH DESCRIPTION
14
14
Menu files add entries to the Debian menu system. The system administrator can place
15
15
menu files in /etc/menu/ to override menu files that packages add to
17
17
other menu files.
18
18
.PP
19
19
This man page may be out of date in some
20
 
places. Look at /usr/doc/menu/html for more up-to-date info.
 
20
places. Look at /usr/share/doc/menu/html for more up-to-date info.
21
21
.PP
22
22
The menu files are usually named after the Debian package that
23
23
contains the programs listed in them. In it, you can list several
24
 
"menuentries", that specify a specific item in the menu
 
24
"menu entries", that specify a specific item in the menu
25
25
"menu entries", that specify a specific item in the menu
26
26
structure. Each menu entry specifies what package it depends on, if
27
27
that package is not installed, the menu entry will be ignored by
90
90
If two menu entries share the same title and section, the one that
91
91
bests fits the available display will be used. So in the example above
92
92
with two menu entries that both have the menu id "title", if X is
93
 
available, the x11 one will be used, otherwise the text one will be used.
 
93
available, the X11 one will be used, otherwise the text one will be used.
94
94
Must be defined.
95
95
.TP
96
96
command
97
97
The command to be executed when this menu entry is selected.
 
98
.TP
 
99
hints
 
100
A comma-separated list of hints on how grouping menu entries, see manual.
98
101
.RE
99
102
.SH "MENU LAYOUT"
100
 
This is the preferred layout of the menus. Currently it is a suggestion
101
 
only. Use `/' to separate sub-menu names, for example, "Apps/Editors" or
 
103
The \fBauthoritative\fP list of Debian's menu structure is maintained in the
 
104
Debian Menu sub-policy document which is part of the Debian Policy package. The
 
105
menu structure below is included only for convenience. Please do not put your
 
106
packages into any other sections. 
 
107
 
 
108
Use `/' to separate sub-menu names, for example, "Apps/Editors" or
102
109
"Games/Arcade".
103
110
.PP
104
 
 \fIApps\fP            -- all normal apps
105
 
   \fIEditors\fP       -- editors
106
 
   \fIEmulators\fP     -- Dosemu, ...
107
 
   \fIGraphics\fP      -- xpaint, xfig, xtiff, 
108
 
   \fIMath\fP          -- Math apps: gnuplot, octave, oleo,..
 
111
 \fIApps\fP            -- Normal apps
 
112
   \fIDatabases\fP     -- Interactive database programs
 
113
   \fIEditors\fP       -- Editors
 
114
   \fIEmulators\fP     -- dosemu, ...
 
115
   \fIEducation\fP     -- Educational and training programs
 
116
   \fIGraphics\fP      -- Image manipulation 
 
117
   \fIHamradio\fP      -- Anything relating to ham radio.
 
118
   \fIMath\fP          -- Math apps: gnuplot, octave, oleo, ...
109
119
   \fINet\fP           -- mail, news, web, irc, etc
110
 
   \fIProgramming\fP   -- debuggers, etc
 
120
   \fIProgramming\fP   -- Debuggers, etc
 
121
   \fIScience\fP       -- Scientific programs
 
122
   \fITools\fP         -- Other tools: xclock, xmag, xman, ...
 
123
   \fITechnical\fP     -- Technical stuff
 
124
   \fIText\fP          -- Text oriented tools other than editors
111
125
   \fIShells\fP        -- Different shells, like bash, zsh, ...
112
 
   \fISound\fP         --
113
 
   \fISystem\fP        -- system administration and monitoring
114
 
   \fITools\fP         -- other tools: xclock, xmag, xman,
 
126
   \fISound\fP         -- Sound players and editors
115
127
   \fIViewers\fP       -- Picture viewers, gs, ...
116
 
 \fIGames\fP           -- games and recreations
117
 
   \fIAdventure\fP     -- walk around virtual space, zork, MOO's, etc
118
 
   \fIArcade\fP        -- (any game where reflexes count)
 
128
   \fISystem\fP        -- System administration and monitoring
 
129
 \fIGames\fP           -- Games and recreations
 
130
   \fIAdventure\fP     -- Walk around virtual space, zork, MOO's, ...
 
131
   \fIArcade\fP        -- Any game where reflexes count
119
132
   \fIBoard\fP         -- Like: Gnuchess, pente, gnugo
120
133
   \fICard\fP          -- solitaire, etc
121
134
   \fIPuzzles\fP       -- Stuff from xpuzzles, ...
122
135
   \fISports\fP        -- Games derived from "real world" sports
123
 
   \fITetris-like\fP   -- games involving falling blocks
124
 
   \fIToys\fP          -- (oneko, xeyes, etc.)
125
 
 \fIScreen\fP          --
126
 
   \fILock\fP          -- xlock, etc.
127
 
   \fIScreen-saver\fP  --
128
 
   \fIRoot-window\fP   -- things that fill the root window
129
 
 \fIWindow-managers\fP -- (change between fvwm, afterstep, etc)
130
 
   \fIModules\fP       -- fvwm modules, etc. 
131
 
 \fIXShells\fP         -- shells (like xterm, rxvt, ...)
 
136
   \fIStrategy\fP      -- Games involving long term strategic thinking
 
137
   \fISimulation\fP    -- Flight simulators, etc
 
138
   \fITetris-like\fP   -- Games involving falling blocks
 
139
   \fIToys\fP          -- oneko, xeyes, etc
 
140
 \fIScreen\fP          -- Programs that affect the whole screen
 
141
   \fILock\fP          -- xlock, etc
 
142
   \fISave\fP          -- Screen savers
 
143
   \fIRoot-window\fP   -- Things that fill the root window
 
144
 \fIWindow-managers\fP -- Switch between fvwm, afterstep, ...
 
145
   \fIModules\fP       -- fvwm modules, etc 
 
146
 \fIXShells\fP         -- Shells (like xterm, rxvt, ...)
132
147
.SH NOTES
133
148
If you want to specify an icon or hotkey for a sub-menu (for example,
134
149
the Editors sub-menu), just use the same syntax but leave the command
142
157
.SH FILES
143
158
(Earlier listed files override later files with the same names.)
144
159
.PP
145
 
.I ~/.menus/*
 
160
.I ~/.menu/*
146
161
.RS
147
162
Menu files added by the user.
148
163
.RE
154
169
.RS
155
170
Menu files provided by other Debian packages.
156
171
.RE
157
 
.I /usr/lib/menu/default/*
 
172
.I /usr/share/menu/default/*
158
173
.RS
159
174
Menu files provided by the menu package.
160
175
.RE
165
180
(Man page by Joey Hess, <joeyh@master.debian.org>)
166
181
.SH "SEE ALSO"
167
182
.BR update-menus (1),
168
 
.BR /usr/doc/menu/html/index.html
 
183
.BR /usr/share/doc/menu/html/index.html