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

<!-- ##### SECTION Short_Description ##### -->
Keeping track of recently used documents.

<!-- ##### SECTION Long_Description ##### -->
<para>
These functions provide ways to store and retrieve a list of
recently used documents.  Applications need to call the
gnome_history_recently_used() routine with the proper arguments to
register a file as having been recently used.  The creator field
should be an action in the format supported by the "open" MIME type
action (for example "program %f", or "program") to re-open the
document.</para>

<para>In the following example, the file
<filename>sales.gnumeric</filename> will be added to the history
of visited documents, the MIME type of the file is
"application/x-gnumeric" and the program that will open this file is
"gnumeric".  Finally, note that the descriptive information is
surrounded by the _() macro to have this item translated to the user's
language at runtime.</para>

<informalexample>
  <programlisting>
gnome_history_recently_used ("sales.gnumeric", 
                             "application/x-gnumeric",
                             "gnumeric",
                             _("Load spreadsheet"));
  </programlisting>
</informalexample>

<para>The following example would keep track of recent talks with a
user:</para>

<informalexample>
  <programlisting>
void record_talk (char *user)
{
    char *message = g_strdup_printf (_("Talk to %s", user);

    gnome_history_recently_used (user, "x-protocol/x-talk",
                                 "gtalk", message);
    g_free (message);
}
  </programlisting>
</informalexample>

<para>To retrieve items from the history, you use the
gnome_history_get_recently_used() function which returns a GList that
contains <structname>GnomeHistoryEntry</structname> structures.  To
release this list, call the
gnome_history_free_recently_used_list().</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### STRUCT GnomeHistoryEntry ##### -->
<para>

</para>


<!-- ##### FUNCTION gnome_history_recently_used ##### -->
<para>

</para>

@filename: 
@filetype: 
@creator: 
@desc: 


<!-- ##### FUNCTION gnome_history_get_recently_used ##### -->
<para>

</para>

@Returns: 


<!-- ##### FUNCTION gnome_history_free_recently_used_list ##### -->
<para>

</para>

@alist: 


