			ROX-Base
			Shared ROX resources
			by Thomas Leonard


Quick start
~~~~~~~~~~~
Type this ($ is the shell prompt):

	$ ./install.sh

and follow the on-screen instructions.


Details
~~~~~~~
This package contains resources needed by several other applications,
including ROX-Filer. It contains:

- Rules for guessing a file's type from its extension.
	(eg, that the file 'something.gif' is of type 'image/gif')
- Icons to represent the various types.
- A few default programs to edit the various types.


Files
~~~~~

Two places are used for MIME-handling configuration files:

<Choices>/MIME-info/*
	Contains the rules for guessing a file's type from its name.
	Many programs come with files called '<prog>.mime' which contain
	additional rules. Put these files in the MIME-info directory too.

<Choices>/MIME-types/*
	Contains programs or symlinks which will be run.
	For example:

	$ rox picture.gif
	is like doing
	$ <Choices>/MIME-types/image_gif picture.gif
	or, if that isn't found,
	$ <Choices>/MIME-types/image picture.gif

In both cases, <Choices> is all the directories in your CHOICESPATH
environment variable, which defaults to:

	~/Choices:/usr/local/share/Choices:/usr/share/Choices

The leftmost directory listed is searched first, followed by the others in
order. If the string starts with a `:' then saving is disabled and no program
will attempt to save any configuration into it. For more details, see:

	<http://rox.sourceforge.net/choices.php3>


Conditions
~~~~~~~~~~
This package is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Please report any bugs to me, Thomas Leonard <tal197@users.sourceforge.net>.


Credits
~~~~~~~
The files have been taken from various sources, and sometimes modified.
Thanks to everyone who's contributed!

In particular:

- The GNOME desktop
- Andrzej Borsuk
- Andrew Clover
- Fabien Devaux
- Victor Liu See-le
