			MIME-Editor
			Editor for the Shared MIME Database
			by Thomas Leonard

Brief
~~~~~
MIME types are used to identify types of file. For example, a plain text
file would have the MIME type 'text/plain'. An HTML page would be 'text/html'
and a PNG image's type is 'image/png'.

ROX-Filer uses MIME types to decide which application to run when you click
on a file, and what icon to give it.

ROX now uses the freedesktop.org Shared MIME Database to deal with MIME
types. Ideally, the shared database will contain most of the types you need,
and applications will add their own types to it automatically. However,
sometimes you may need to edit the database manually, and MIME-Editor is a
graphical editor for this. If a type is missing, consider asking for it to
be added to the main database.

The latest version of MIME-Editor is at:

	http://rox.sourceforge.net


Conditions
~~~~~~~~~~
This program 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 program 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, <tal197@users.sourceforge.net>


Instructions
~~~~~~~~~~~~
The main window shows all the types currently registered on your system. The
information is collected from various directories (see the MIME spec).
You can add or remove types from this window, or edit an existing type.
Note that you can only remove types which you added yourself.

After any changes, the database is rebuilt. You MUST have the shared MIME
database package installed for this to work (address below), but ROX-Filer
already requires it. However, if you're using Zero Install, the database
will be cached automatically, and you don't need to install anything.

If you double-click on a type (or use the Properties button) you will be
shown all the information held about that type. Some is provided by packages
you have installed (shown greyed out) and some is information which you have
provided yourself.

The information about a type is divided into groups:

Name matching
	This section lists filenames which should be given this type.
	For example, a '*.html' match means that a file called 'index.html'
	will get that type.

Descriptions
	This section is used to provide a textual description for the type,
	for example, the text/html type might have "HTML Web page" as its
	description. You can also add translations into other languages
	here.

Contents matching
	Some programs (but not ROX-Filer) will look at the contents of a file
	to work out its type. Rules for this go here, and are somewhat
	complicated. See the MIME spec for details.

XML namespace matching
	For XML files, a more reliable way to determine the type than searching
	for strings or numbers at fixed locations (as with Contents matching)
	is to check the namespace and name of the root element. No programs
	currently use this method, but you can add rules here anyway.

Others
	Anything that MIME-Editor doesn't understand goes here. Other programs
	are free to provide extra information, but you can't edit it with
	this program.

Double-click on one of the group headings to add a new entry to that group
(or select the heading and click the Add button). Double click a field within
a group to edit it (only if not shaded), or use the Properties button.

Use 'Add' on a field in Contents matching to add a match to it (these can
be nested).

Although you can't edit the system-provided information, any information
you provide will override it. For example, if the system says that *.mod
is 'audio/x-mod' but you want it to be 'application/x-my-app-module' then
just add a 'Name matching' rule to 'application/x-my-app-module' and it
will override the old rule.

Your changes are stored in the file ~/.local/share/mime/Override.xml. If you
edit the file manually, be sure to rerun the update-mime-database command too.

For more information, see the MIME spec:

	http://www.freedesktop.org/standards/shared-mime-info.html
