.TH XFM_MIME.TYPES 5 "20 April, 2006" "xfm" XFM
.\" Copyright (C) 2006, Bernhard R. Link <brlink@debian.org>
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file COPYING that comes with xfm.
.SH NAME
xfm_mime.types \- suffix based fall back mime type information
.SH DESCRIPTION
When \fIxfm\fP(1) cannot determine the type of a file using the values
in \fIxfm_magic\fP(5),
this file is used to guess a type of a file.
The file shipped with \fIxfm\fP by default just tells to include
the files
.IB ~ /.mime.types
and
.B /etc/mime.types
to get the system wide settings.
.SH FORMAT
There is one entry per line.
Empty lines and lines starting with a hash (#) are ignored.
Prior entries overwrite later ones.

If a line starts with
.B !include
or
.B include
the rest of the line is treated as a filename to process before
continuing with the rest of the file.
(If the filename starts with a tilde followed by a slash,
the tilde is replaced by the content of the
.I HOME
environment variable.)

Other lines contain the name of a \fImime type\fP followed by
an arbitrary number of filename \fIsuffixes\fP, separated by spaces or tabs.

A file that got no other type associated by content and whose name ends with a dot
followed by the specified \fBsuffix\fP,
will be treated as type \fBmime type\fP.

\fIXfm\fP only recognizes suffixes with at most 7 characters.
.SH EXAMPLES
Otherwise unidentified files anding in \fB.c\fP are treated as \fBtext/x\-csrc\fP:
.br
\fBtext/x\-csrc                                     c\fP
.br
Same with \fB.c++\fP, \fBcpp\fP, \fBcxx\fP or \fBcc\fP as \fBtext/x\-c++src\fP:
.br
\fBtext/x\-c++src                                   c++ cpp cxx cc\fP
.br
.SH FILES
.TP
.IB $HOME /.xfm/xfm_mime.types
Unless \fBxfm\fR(1) is told to look at a different place via X resource \fBXfm.mimeTypesFile\fP, this
is the first place xfm looks for a file with the describes format.
.TP
.B /etc/X11/xfm/xfm_mime.types
If the first file does not exists, \fBxfm\fP(1) (unless it gets told a different place
via the X resource \fBXfm.systemwideMimeTypesFile\fP) looks for this file.
.TP
.IB $HOME /.mime.types
General user settings normaly included from
.B /etc/X11/xfm/xfm_mime.types
.TP
.B /etc/mime.types
General system wide settings normaly included from
.B /etc/X11/xfm/xfm_mime.types
.SH "SEE ALSO"
.BR xfm (1)