ROX-Menu version 0.5.0
Simple application menu for the ROX Desktop environment.
Web site: http://www.cs.sunyit.edu/~geerp/rox

Copyright (C) 2001 Leandro Pereira <leandro@linuxmag.com.br>
Copyright (C) 2002, 2003 Peter Geer <geerp@cs.sunyit.edu>

Current maintainer: Peter Geer <geerp@cs.sunyit.edu>

- - -

ROX-Menu is a simple panel applet for ROX-Filer and the ROX desktop that
pops up a menu that you can use to start your favorite application 
directories.  It serves the same purpose as the KDE "K" menu or the 
Windows "Start" menu.

Installation
~~~~~~~~~
To install ROX-Menu, simply extract the archive to the directory where 
you keep your ROX applications and click on the ROX-Menu application 
directory to run it.  When you first run ROX-Menu, it will compile 
itself if a binary is not present and create a default configuration 
if you do not have one.

Menu Configuration
~~~~~~~~~~~~~~~~~~
As of version 0.5.0, ROX-Menu uses the filesystem for configuration.
Adding items to the menu is done by creating links and directories, while
sorting of menu items is done by renaming directories.  Please note that
the old "Apps" configuration file is still supported.  If the file is present,
it will be used, but it is considered deprecated.

To configure your menu, right-click on the running applet and select
"Choices dir...".  In the ROX-Filer window that pops up, there should be
a directory named "Menu_Root".  This directory represents the top-level
menu of ROX-Menu.  You can add menu items by adding AppDirs or symlinks
to AppDirs to this directory.  You can also create submenus by adding 
subdirectories containing AppDirs to the Menu_Root.  You can, likewise,
create as many levels of submenus as you like by adding subdirectories
to the subdirectories. These can be real directories containing symlinks to 
AppDirs, or symlinks to real directories, or a combination of real AppDirs, 
directories, and symlinks.  Note that ROX-Menu will ignore hidden files
and directories and will ignore all regular files, i.e. not AppDirs or
symlinks to them.


Options
~~~~~~~
There are a few configuration options for ROX-Menu that can be modified 
by choosing "Options" from the context menu.  Any changes to these 
options will not take effect until you press the "Apply" button.  First,
the maximum height and width of the ROX-Menu icon can be specified. 
Rather than displaying the image at actual size, ROX-Menu will scale the
icon such that it is no larger than the height and width provieded.  
Since the size of the icon determines the size of the applet, you can 
scale the icon down if ROX-Menu makes your panel increase in size.  The
default maximum sizes are 38 pixels high and 60 pixels wide, which 
corresponds to the default icon.

ROX-Menu also has an option to set the "Mouse-over" and "Normal" icons 
for the menu.  These are simply the icons that are displayed when your 
mouse is over the applet or not over it, respectively.  They can be in 
any format and should be between 30 and 50 pixels high for most panels.  The
default icons are images of the ROX eagle.  (The mouse-over icon is the
same image as the normal icon, but darkened slightly.)  There are some 
alternative menu icons in the src/Alt_Icons and src/Old_Icons directories.

There is an option to control the position of the group entries
in nested submenus.  By default, they are at the top of the submenu.
When the "groups on bottom" option is specified, nested group entries
will appear at the bottom of the submenu after all the AppDirs are
listed.

Lastly, there is an option to strip initial numbers from entry names.
When this is set, ROX-Menu will examine the name of each AppDir and directory
it adds to the menu.  If the name starts with a digit (0-9), then
ROX-Menu will search for the first underscore in the name and set the
menu item text to everything after this point.  Thus, the name
"1_Sylpheed" would display as "Sylpheed" and "2a_Opera" as "Opera".
Since the menu items are sorted alphabetically, this allows you to
manually sort the names without having them displayed in the menu.

Multiple Independent Configurations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
As of RoX-Menu 0.5.0, it is possible to run multiple, independent
ROX-Menu configuration simultaneously.  This will allow you to put two
instances of ROX-Menu in your pane, but have them display different
menus, have different icons, and different behavior.

To do this, simply create a copy of or symlink to the ROX-Menu AppDir
with a different name and the configuration will be stored in your
Choices directory under a directory of the same name.  For example, you might 
create a symlink to ROX-Menu called "Start-Menu".  You can then drag the 
"ROX-Menu" and the "Start-Menu" AppDirs to your panel and run them both.  The
configuration for the "Start-Menu" configuration will be stored in a directory
named Start-Menu located under your Choices directory.  

License
~~~~~~~
This program is licensed under the GNU General Public License version 2.
A copy of the license is available in the COPYING file located in this
directory.

