(menu.info)Section 3.2

---

Next: Section 3.3 Prev: Section 3.1 Up: Chapter 3

---

Enter node , (file) or (file)node

3.2 Syntax
==========

The format is:

     ?package(package[,package2,...]): \
        field1="value1"\
        field2="value2"\

Here is an example to describe the syntax of such a file:

     ?package(gnumeric):\             specifies what packages need to be installed
                                      multiple requirements should be separated by
                                      comma
       needs="X11"\                   what kind of environment this command expects
       section="Applications/Office"\ in what section this menu entry should be
       title="Gnumeric"\              the title of the menu entry
       command="gnumeric" \           the command to run
       hints="Gnome,Spreadsheets" \   some hints about menu placement.
       icon="/usr/share/pixmaps/gnumeric.xpm"  the path to the icon to use.

A number sign ("#") can be used to include comments.  An entry must be
terminated by a newline; however you can use a backslash to escape a
newline.

Values must be quoted with ", and meta-characters (", backslash,
newline) must be escaped with a backslash.

You can include several entries in the same file.

The file must be encoded in 7-bit ASCII. This is necessary to accomodate
window managers that do not support 8-bit encodings.  However the
translations are not limited in encoding.

'?package(...)' contains a comma-separated list of packages that need to
be installed for the menu entry to be displayed.  That should include
the package containing the menu file and any packages necessary to run
the command not depended on by the package nor essential.  Users can use
pseudo-package names starting with "'local.'" which are assumed to be
always installed.

The fields 'needs', 'section', 'title' and 'command' are mandatory.
Other fields are optional.  Custom fields are supported, so you can add
new fields for you own purpose.  If a field is specified multiple times
in a menu entry, the last instance will be used.