<!-- ##### 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: