<!-- ##### SECTION Title ##### -->
GnomeEntry

<!-- ##### SECTION Short_Description ##### -->
Entry widget with history tracking.

<!-- ##### SECTION Long_Description ##### -->
<para>
  This widget is a wrapper around the #GtkEntry widget, but it provides
  a history mechanism for all the input entered into the widget.  The
  way this works is that a special identifier is provided when
  creating the <type>GnomeEntry</type> widget, and this identifier
  is used to load and save the history of the text.
</para>

<para>
  Here is an example of how to use the widget

  <example>
     <title>Sample usage of the GnomeEntry widget</title>
     <programlisting>
GtkWidget *gnomeentry, *gtkentry;
char *text;

...

/* create a gnome entry */
gnomeentry = gnome_entry_new("some_history_id");

/* get the GtkEntry widget */
gtkentry = gnome_entry_gtk_entry (GNOME_ENTRY (gnomeentry));

/* set the text to "BLAH" */
gtk_entry_set_text(GTK_ENTRY(gtkentry), "BLAH");

...

/*somewhere else we wish to retrieve the contents*/
text = gtk_entry_get_text(GTK_ENTRY(gtkentry));
     </programlisting>
  </example>
</para>


<!-- ##### SECTION See_Also ##### -->
<para>
  #GnomeFileEntry, #GnomeIconEntry, #GnomePixmapEntry, #GnomeNumberEntry
</para>

<!-- ##### STRUCT GnomeEntry ##### -->
<para>

</para>


<!-- ##### FUNCTION gnome_entry_new ##### -->
<para>

</para>

@history_id: 
@Returns: 


<!-- ##### FUNCTION gnome_entry_gtk_entry ##### -->
<para>

</para>

@gentry: 
@Returns: 


<!-- ##### FUNCTION gnome_entry_set_history_id ##### -->
<para>

</para>

@gentry: 
@history_id: 


<!-- ##### FUNCTION gnome_entry_prepend_history ##### -->
<para>

</para>

@gentry: 
@save: 
@text: 


<!-- ##### FUNCTION gnome_entry_append_history ##### -->
<para>

</para>

@gentry: 
@save: 
@text: 


<!-- ##### FUNCTION gnome_entry_load_history ##### -->
<para>

</para>

@gentry: 


<!-- ##### FUNCTION gnome_entry_save_history ##### -->
<para>

</para>

@gentry: 


