===========================================================================
FREQUENTLY ASKED QUESTIONS for IceMe
===========================================================================


Q: Some drag and drop / cut and paste operations don't work?

A: It is not allowed to modify the grey entries, ie. the menus "IceWM",
   "Programs", "Toolbar", "Clipboard" and the separators between them.
   Any attempt to move, cut, or delete them is silently rejected.
   

Q: IceMe always saves the menus to $HOME. How can I edit the default menus
   in /usr/X11R6/lib/X11/icewm (or /etc/X11/icewm)?

A: Start IceMe with the --ignore-home switch. Use the --help options to
   view a list of available options.


Q: How does IceMe look for icons?

A: IceMe tries hard to look for icons in the same way as IceWM does. If 
   you enter an icon name, say "name", IceMe will look in the following
   directories, in the following order:
   
   1. $HOME/.icewm/themes/<Theme>/icons
   2. $HOME/.icewm/icons
   3. /etc/X11/icewm/themes/<Theme>/icons
   4. /etc/X11/icewm/icons
   5. <lib_dir>/icewm/themes/<Theme>/icons
   6. <lib_dir>/icewm/icons
   7. the paths from the <IconPath> preference
   
   where
   
   <lib_dir>  denotes the directory, where you installed icewm with the
              configure --libdir="..." option. It defaults to
              /usr/local/lib, but the rpm versions point to /usr/X11R6/lib.
   <Theme>    denotes the directory name of the preference "Theme=..." and
   <IconPath> denotes the preference "IconPath"
   
   of either your own preferences in $HOME/.icewm/preferences or the global
   preferences in <lib_dir>/icewm/preferences. (The home is searched first).
   
   Note: Since IceMe does not know the lib_dir, that was chosen for IceWM,
   it simply tries the directories /usr/local/lib and /usr/X11R6/lib, in that
   order. You can override this by giving a directory name on the command
   line (see README). Note, that IceMe will still look in /etc/X11/icewm
   before looking in the directory specified on the commandline. This is in
   conformance with IceWM.
   
   In each directory, IceMe will look for the following icon filenames:
   
   1. name_16x16.xpm
   2. mini/name.xpm
   
   That is, it will _not_ look for name.xpm in the directory itself, but in a
   subdirectory called mini. This is to ensure that the icon is not a large
   one. Keep this in mind, when you use KDE and wish to include the KDE icon
   collection in the IceWM icon path. Enter:
   
   IconPath="/opt/kde/share/icons"
   
   and not:
   
   IconPath="/opt/kde/share/icons/mini"


Q: What is the format for IceWM menu files?

A: It's pretty self explaining. Just look at the default one from the
   distribution. For freaks: here is a description in EBNF (I guess!):
   
   <line>       := (<menu> | <command> | <separator> | <comment>) EOL
   <menu>       := 'menu' <name> <icon> '{' EOL [<line>]* EOL '}'
   <command>    := ('prog' | 'restart') <name> <icon> <string>
   <separator>  := 'separator'
   <comment>    := '#' <string>
   <name>       := <identifier>
   <icon>       := <identifier> | '"-"'
   <identifier> := ['"'] <string> ['"']
   
