<!-- ##### SECTION Title ##### -->
gnome-mime

<!-- ##### SECTION Short_Description ##### -->
Routines to determine the MIME type of a file

<!-- ##### SECTION Long_Description ##### -->
<para>
The routines in gnome-mime provide a way to obtain the MIME (Multipurpose
Internet Mail Extension) type of a given file and some utility functions.
</para>

<para>
There are two different methods for getting the MIME type of a particular file:
Using only the filename to find the corresponding MIME type by matching the
name against a database of known extensions and regular expressions; Or
obtaining the MIME type by peeking at the contents of the file. 
Generally it should be faster using the former method, because the routines
only do in-memory operations, while the latter method needs to do possibly
time-expensive disk operations to obtain the necessary information.
</para>

<para>
The routines that classify a file only by its name, look at the
<filename>*.mime</filename> files in the
<filename>$gnome_prefix/share/mime-info/</filename> directory and in
<filename>~/.gnome/mime-info/</filename> to build the extension
database. This gives the user the possibility to extend and/or override the
system defaults.
</para>

<para>
Applications wanting to make additional MIME types available only need to
install their files in one of these directories.
</para>

<para>
The file <filename>$gnome_prefix/share/mime-info/gnome.mime</filename>
contains the defaults for Gnome and is read first. In addition,
<filename>~/.gnome/mime-info/user.mime</filename> is the last file to be
read and thus makes it possible to set system-wide defaults and still
gives the user a chance to override them. However, there is currently no
determined order in which the other files in these directories will be
read, nor is there any way to override system defaults, yet.
</para>

<para>
The gnome_mime_type_from_magic() function looks at the
<filename>$gnome_prefix/etc/mime-magic</filename> file to determine the
MIME type of a given file (This database in usually kept in a
pre-processed, easily readable format in
<filename>$gnome_prefix/etc/mime-magic.dat</filename>).
</para>
    
<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### FUNCTION gnome_mime_type ##### -->
<para>

</para>

@filename: 
@Returns: 


<!-- ##### FUNCTION gnome_mime_type_or_default ##### -->
<para>

</para>

@filename: 
@defaultv: 
@Returns: 


<!-- ##### FUNCTION gnome_mime_type_of_file ##### -->
<para>

</para>

@existing_filename: 
@Returns: 


<!-- ##### FUNCTION gnome_mime_type_or_default_of_file ##### -->
<para>

</para>

@existing_filename: 
@defaultv: 
@Returns: 


<!-- ##### FUNCTION gnome_mime_type_from_magic ##### -->
<para>

</para>

@filename: 
@Returns: 


<!-- ##### FUNCTION gnome_uri_list_extract_filenames ##### -->
<para>

</para>

@uri_list: 
@Returns: 


<!-- ##### FUNCTION gnome_uri_list_extract_uris ##### -->
<para>

</para>

@uri_list: 
@Returns: 


<!-- ##### FUNCTION gnome_uri_list_free_strings ##### -->
<para>

</para>

@list: 


