aboutsummaryrefslogblamecommitdiffstats
path: root/mail/em-mailer-prefs.c
blob: 9f12c4522ccda7a14663269c2dd153aeb53f9761 (plain) (tree)
1
2
3
4
5



                                                                           
                                                     





















                                                                        

                   
                            
 
                             
                                       
                        
                                          

                                          


                        


                                                                   


                                         







                                                                                            






                            















                                                           

       
                               
 
                              

                    
                                       
                                                    
                                   
                                                                    
                                   
                                               
                          
                                                                 

                  
                                                                                                     





                    
                                                      
 
                                   
        
                                              
                                                               
        
                                                          


           
                                                 
 
                                                             


           
                                       
 
                                                     
        
                                    
        
                                                         



           
                                                                
 





                                                                                                     










                                                                                                         
                  
                  
                  
                  
                  




                   
                                                        
 
                                                           
                                                
        







                                                                                                                                       
        




                                                                  

                                                     
                                                           













                                                                                 
                                                           





                                                                  

                                                                                     
                                                           





                                                                  

                                                              
                                                           


                                 
                                                                                      
                                                                                         



           

                                                    
                                                           





                                                                  









                                                              
                                                                                          



                                    




























                                                                                               

                           
                             
        




                                               
        








                                                  
        








                                                                                 
        



                                                                                                 
                



                                                                                      
                                                                                         

                               

                                                                                                    
         
        










                                                                                                           
        



                                                                                      
                                         
                                  
        









                                                                        







                                                                                                 


                                                     
        























                                                                                       
        






                                                                
        


                                            
           

























































                                                                                                                                
                                                
 

                                                                
                                   



                                    
                      
                                        

                   
                                                                                               






                                                          

                                                                          





                                                                                                 


                                                                         

                                                                                         


                                                                           

                                                                                      
                                                                                                   
                                                                                    
                                                                     
                                                    

                                                                                                       
                     

                                                                                                            


                                                                          

                                                                                                                 
                                                                                                           
                                                                             
                                                                                             

                                                                                                               
                     


                                                                                                   


                                                                         

                                                                                                     
                                                                 

                                                                         

                                   

                                                                                                        
                                                                                            
                                                                                           
                                                                                        
                                                                                              

                                                                                  

                                                                                             
                                                                                          
                                                                                               

                                                                                   

                                                                                                        
                                                                                                      
                                                                                                     

                                                                                         

                                                                                                        

                                                                                                               
                                                                                           
                                                                

                                                                                                    
                     
        




                                                                                                            

                                                                                                               




                                                                                                           


                                                                                                              
                                                                                             


                                                                            
                                                                   
        


                            
                                                                                                                     
        
                                                                                                         
                                                                                               
                                                                                          
                                                                                                

                                                                                    

                                                                                                       
                                                                                                  
                                                                                                    

                                                                                        

                                                                                                 
                                                                                            
                                                                                                 

                                                                                     
        
                                                                                                       



                                                                          
                                                                                                          


                                                                         
        

                                                                                                   






                                         


                                                                                            
                                                                                        
                                     


                                                                                                      
                                                                                         
                                     
                
                                                                        
                                                                                                          
                
                                                                              
                                                                                                      
                

                                  

         
                                                                                            
                                                                                
                                                                                                        
        
                     

                                                                                                            
                                                                                     

                                                                            
                                                                                           

                                                                               
                                                                                   

                                                                              
                                                                                       

                                                                             




                                                                                                         
                                                                                          


                                                                                                          



                                                                                                     
                                                                                             
                                                                         

                                                                                           
                                                 
                                                                                             
                                                                      

                                                                                      
        







                                                                                                    
                

                                                                    
                                                             



                                                                                                
                                                                                                 

                                                                      
        



                                                                                                                                    
                                                     

                                             

                                                          
                                                                                 

                                                          
                                                                




                                                                                      

                            
         
        


                                                                   
        

                            
                                                                                         
                                 
                



                                                                                
                






                                                                                  


                                                
         
        

                                               
        
                        




                                                                                                         
                                                                                                       




                                                                              


                                                                                           
                                                                                                           



                                                                         
                                                                                                


                                                                         

 
           
                          
 
                           
        

                                                                                 





                                 
                                            

                                
                              
                            
                             
                    
                   


                            



                             

                                                                                           
        
                                                                          
                                                                                                         

                                                         
                                                            
                                                              
        
                                                                                                     
                        
        
                                                                                           
                                                                                               

                                                            
                                              
                                                                                                          

                           

                                                                                        
        

                                                                                            


                                                             
                                             
                                                                   
                                              
            


                                                                                           

                                                                                         
                                                         
                                                                                                   


                                                                
                                              
                                                                        
                                                 
            



                                                                                                        





                                                                                               

                                                                                           
        

                                                                                                 
        
                                


                                                                     
                                                                     
                                                                               
                                                      
         
        
                                                                                                            


                           
                            
                                 

                                   
         
        






                                                                                                 
                




                                                                                      

                                                               
                                                                        
                

                                                                                                    
        


                                                                                                                            
        


                                                                                           

                                                                                                 



                                                                                                
        
                                                       
 



                                       
                                       

                        
        

                            
        


                                               
        


                                         
        


                                                             
        



                                         
        














                                                       
                                            


                                                
                            
        

                                               
        














                                                                 
        


















                                                                   
        

                                                          
        
                                
        



                                                         
        


                                            
        

                                  
                         
                      
        

                   
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
 *  Authors: Jeffrey Stedfast <fejj@ximian.com>
 *
 *  Copyright 2002-2003 Ximian, Inc. (www.ximian.com)
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Street #330, Boston, MA 02111-1307, USA.
 *
 */


#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

#include <string.h>

#include "em-mailer-prefs.h"

#include <gal/util/e-iconv.h>
#include <gtkhtml/gtkhtml-properties.h>
#include <libxml/tree.h>
#include "widgets/misc/e-charset-picker.h"
#include <bonobo/bonobo-generic-factory.h>

#include "mail-config.h"


static void em_mailer_prefs_class_init (EMMailerPrefsClass *class);
static void em_mailer_prefs_init       (EMMailerPrefs *dialog);
static void em_mailer_prefs_finalise   (GObject *obj);

static GtkVBoxClass *parent_class = NULL;

enum {
    HEADER_LIST_NAME_COLUMN, /* displayable name of the header (may be a translation) */
    HEADER_LIST_ENABLED_COLUMN, /* is the header enabled? */
    HEADER_LIST_IS_DEFAULT_COLUMN,  /* is this header a default header, eg From: */
    HEADER_LIST_HEADER_COLUMN, /* the real name of this header */
    HEADER_LIST_N_COLUMNS, 
};

static GType col_types[] = {
    G_TYPE_STRING,
    G_TYPE_BOOLEAN,
    G_TYPE_BOOLEAN,
    G_TYPE_STRING
};

/* temporarily copied from em-format.c */
static const struct {
    const char *name;
    guint32 flags;
} default_headers[] = {
    { N_("From"), EM_FORMAT_HEADER_BOLD },
    { N_("Reply-To"), EM_FORMAT_HEADER_BOLD },
    { N_("To"), EM_FORMAT_HEADER_BOLD },
    { N_("Cc"), EM_FORMAT_HEADER_BOLD },
    { N_("Bcc"), EM_FORMAT_HEADER_BOLD },
    { N_("Subject"), EM_FORMAT_HEADER_BOLD },
    { N_("Date"), EM_FORMAT_HEADER_BOLD },
    { "x-evolution-mailer", 0 }, /* DO NOT translate */
};

#define EM_FORMAT_HEADER_XMAILER "x-evolution-mailer"

GtkType
em_mailer_prefs_get_type (void)
{
    static GType type = 0;
    
    if (!type) {
        GTypeInfo type_info = {
            sizeof (EMMailerPrefsClass),
            NULL, NULL,
            (GClassInitFunc) em_mailer_prefs_class_init,
            NULL, NULL,
            sizeof (EMMailerPrefs),
            0,
            (GInstanceInitFunc) em_mailer_prefs_init,
        };
        
        type = g_type_register_static (gtk_vbox_get_type (), "EMMailerPrefs", &type_info, 0);
    }
    
    return type;
}

static void
em_mailer_prefs_class_init (EMMailerPrefsClass *klass)
{
    GObjectClass *object_class;
    
    object_class = (GObjectClass *) klass;
    parent_class = g_type_class_ref (gtk_vbox_get_type ());
    
    object_class->finalize = em_mailer_prefs_finalise;
}

static void
em_mailer_prefs_init (EMMailerPrefs *preferences)
{
    preferences->gconf = mail_config_get_gconf_client ();
}

static void
em_mailer_prefs_finalise (GObject *obj)
{
    EMMailerPrefs *prefs = (EMMailerPrefs *) obj;
    
    g_object_unref (prefs->gui);
    
        ((GObjectClass *)(parent_class))->finalize (obj);
}


static void
colorpicker_set_color (GnomeColorPicker *color, const char *str)
{
    GdkColor colour;
    guint32 rgb;
    
    gdk_color_parse (str, &colour);
    rgb = ((colour.red & 0xff00) << 8) | (colour.green & 0xff00) | ((colour.blue & 0xff00) >> 8);
    
    gnome_color_picker_set_i8 (color, (rgb & 0xff0000) >> 16, (rgb & 0xff00) >> 8, rgb & 0xff, 0xff);
}

static guint32
colorpicker_get_color (GnomeColorPicker *color)
{
    guint8 r, g, b, a;
    guint32 rgb = 0;
    
    gnome_color_picker_get_i8 (color, &r, &g, &b, &a);
    
    rgb   = r;
    rgb <<= 8;
    rgb  |= g;
    rgb <<= 8;
    rgb  |= b;
    
    return rgb;
}

static void
settings_changed (GtkWidget *widget, gpointer user_data)
{
    EMMailerPrefs *prefs = (EMMailerPrefs *) user_data;
    gboolean check_incoming, locked = FALSE;
    
    if (prefs->check_incoming && prefs->check_incoming_imap) {
        /* this callback can get called in _construct() before
         * these widgets have been created */
        if ((check_incoming = gtk_toggle_button_get_active (prefs->check_incoming)))
            locked = gconf_client_key_is_writable (prefs->gconf, "/apps/evolution/mail/junk/sa/check_incoming_imap", NULL);
        
        gtk_widget_set_sensitive (GTK_WIDGET (prefs->check_incoming_imap), check_incoming && !locked);
    }
    
    if (prefs->control)
        evolution_config_control_changed (prefs->control);
}

static void
font_share_changed (GtkWidget *w, gpointer user_data)
{
    EMMailerPrefs *prefs = (EMMailerPrefs *) user_data;
    gboolean use_custom;

    use_custom = !gtk_toggle_button_get_active (prefs->font_share);

    gtk_widget_set_sensitive (GTK_WIDGET (prefs->font_fixed), use_custom);
    gtk_widget_set_sensitive (GTK_WIDGET (prefs->font_variable), use_custom);

    if (prefs->control)
        evolution_config_control_changed (prefs->control);
}

static void
font_changed (GnomeFontPicker *fontpicker, gchar *arg1, gpointer user_data)
{
    EMMailerPrefs *prefs = (EMMailerPrefs *) user_data;
    
    if (prefs->control)
        evolution_config_control_changed (prefs->control);
}

static void
color_set (GtkWidget *widget, guint r, guint g, guint b, guint a, gpointer user_data)
{
    EMMailerPrefs *prefs = (EMMailerPrefs *) user_data;
    
    if (prefs->control)
        evolution_config_control_changed (prefs->control);
}

static void
restore_labels_clicked (GtkWidget *widget, gpointer user_data)
{
    EMMailerPrefs *prefs = (EMMailerPrefs *) user_data;
    int i;
    
    for (i = 0; i < 5; i++) {
        gtk_entry_set_text (prefs->labels[i].name, _(label_defaults[i].name));
        colorpicker_set_color (prefs->labels[i].color, label_defaults[i].colour);
    }
}

static void
menu_changed (GtkWidget *widget, gpointer user_data)
{
    EMMailerPrefs *prefs = (EMMailerPrefs *) user_data;
    
    if (prefs->control)
        evolution_config_control_changed (prefs->control);
}

static void
option_menu_connect (GtkOptionMenu *omenu, gpointer user_data)
{
    GtkWidget *menu, *item;
    GList *items;
    
    menu = gtk_option_menu_get_menu (omenu);
    
    items = GTK_MENU_SHELL (menu)->children;
    while (items) {
        item = items->data;
        g_signal_connect (item, "activate", G_CALLBACK (menu_changed), user_data);
        items = items->next;
    }
}


static void
emmp_header_remove_sensitivity (EMMailerPrefs *prefs)
{
    GtkTreeIter iter;
    GtkTreeSelection *selection = gtk_tree_view_get_selection (prefs->header_list);
    gboolean is_default;

    /* remove button should be sensitive if the currenlty selected entry in the list view 
           is not a default header. if there are no entries, or none is selected, it should be 
           disabled
    */
    if (gtk_tree_selection_get_selected (selection, NULL, &iter)) {
        gtk_tree_model_get (GTK_TREE_MODEL (prefs->header_list_store), &iter, 
                    HEADER_LIST_IS_DEFAULT_COLUMN, &is_default, 
                    -1);
        if (is_default)
            gtk_widget_set_sensitive (GTK_WIDGET (prefs->remove_header), FALSE);
        else
            gtk_widget_set_sensitive (GTK_WIDGET (prefs->remove_header), TRUE);
    } else {
        gtk_widget_set_sensitive (GTK_WIDGET (prefs->remove_header), FALSE);
    }
}

static gboolean
emmp_header_is_valid (const char *header)
{
    const char *p = header;
    
    if (header[0] == 0)
        return FALSE;
    
    while (*p) {
        if ((*p == ':') || (*p == ' '))
            return FALSE;
        p++;
    }
    
    return TRUE;
}

static void
emmp_header_add_sensitivity (EMMailerPrefs *prefs)
{
    const char *entry_contents;
    GtkTreeIter iter;
    gboolean valid;
    
    /* the add header button should be sensitive if the text box contains 
       a valid header string, that is not a duplicate with something already 
       in the list view
    */
    entry_contents = gtk_entry_get_text (GTK_ENTRY (prefs->entry_header));
    if (!emmp_header_is_valid (entry_contents)) {
        gtk_widget_set_sensitive (GTK_WIDGET (prefs->add_header), FALSE);
        return;
    }
    
    /* check if this is a duplicate */
    valid = gtk_tree_model_get_iter_first (GTK_TREE_MODEL (prefs->header_list_store), &iter);
    while (valid) {
        char *header_name;
        
        gtk_tree_model_get (GTK_TREE_MODEL (prefs->header_list_store), &iter, 
                    HEADER_LIST_HEADER_COLUMN, &header_name, 
                    -1);
        if (g_ascii_strcasecmp (header_name, entry_contents) == 0) {
            gtk_widget_set_sensitive (GTK_WIDGET (prefs->add_header), FALSE);
            return;
        }
        
        valid = gtk_tree_model_iter_next (GTK_TREE_MODEL (prefs->header_list_store), &iter);
    }
    
    gtk_widget_set_sensitive (GTK_WIDGET (prefs->add_header), TRUE);
}

static void
emmp_header_list_enabled_toggled (GtkCellRendererToggle *cell, const char *path_string, gpointer user_data)
{
    EMMailerPrefs *prefs = (EMMailerPrefs *) user_data;
    GtkTreeModel *model = GTK_TREE_MODEL (prefs->header_list_store);
    GtkTreePath *path = gtk_tree_path_new_from_string (path_string);
    GtkTreeIter iter;
    int enabled;
    
    gtk_tree_model_get_iter (model, &iter, path);
    gtk_tree_model_get (model, &iter, HEADER_LIST_ENABLED_COLUMN, &enabled, -1);
    enabled = !enabled;
    gtk_list_store_set (GTK_LIST_STORE (model), &iter, HEADER_LIST_ENABLED_COLUMN,
                enabled, -1);
    gtk_tree_path_free (path);
    
    if (prefs->control)
        evolution_config_control_changed (prefs->control);
}

static void
emmp_header_add_header (GtkWidget *widget, gpointer user_data)
{
    EMMailerPrefs *prefs = (EMMailerPrefs *) user_data;
    GtkTreeModel *model = GTK_TREE_MODEL (prefs->header_list_store);
    GtkTreeIter iter;
    
    gtk_list_store_append (GTK_LIST_STORE (model), &iter);
    gtk_list_store_set (GTK_LIST_STORE (model), &iter, 
                HEADER_LIST_NAME_COLUMN, gtk_entry_get_text (prefs->entry_header), 
                HEADER_LIST_ENABLED_COLUMN, TRUE, 
                HEADER_LIST_HEADER_COLUMN, gtk_entry_get_text (prefs->entry_header), 
                HEADER_LIST_IS_DEFAULT_COLUMN, FALSE, 
                -1);
    gtk_entry_set_text (prefs->entry_header, "");
    emmp_header_remove_sensitivity (prefs);
    emmp_header_add_sensitivity (prefs);
    
    if (prefs->control)
        evolution_config_control_changed (prefs->control);
}

static void
emmp_header_remove_header (GtkWidget *button, gpointer user_data)
{
    EMMailerPrefs *prefs = (EMMailerPrefs *) user_data;
    GtkTreeModel *model = GTK_TREE_MODEL (prefs->header_list_store);
    GtkTreeSelection *selection = gtk_tree_view_get_selection (prefs->header_list);
    GtkTreeIter iter;
    
    if (gtk_tree_selection_get_selected (selection, NULL, &iter)) {
        gtk_list_store_remove (GTK_LIST_STORE (model), &iter);
        emmp_header_remove_sensitivity (prefs);
        if (prefs->control)
            evolution_config_control_changed (prefs->control);
    }
}

static void 
emmp_header_list_row_selected (GtkTreeSelection *selection, gpointer user_data)
{
    EMMailerPrefs *prefs = (EMMailerPrefs *) user_data;
    
    emmp_header_remove_sensitivity (prefs);
}

static void
emmp_header_entry_changed (GtkWidget *entry, gpointer user_data)
{
    EMMailerPrefs *prefs = (EMMailerPrefs *) user_data;
    
    emmp_header_add_sensitivity (prefs);
}

static void
spin_button_init (GtkSpinButton *spin, GConfClient *gconf, const char *key, float div, GCallback value_changed, void *user_data)
{
    GError *err = NULL;
    double min, max;
    char *mkey, *p;
    int val;
    
    gtk_spin_button_get_range (spin, &min, &max);
    
    mkey = g_alloca (strlen (key) + 5);
    p = g_stpcpy (mkey, key);
    *p++ = '_';
    
    /* see if the admin locked down the min value */
    strcpy (p, "min");
    val = gconf_client_get_int (gconf, mkey, &err);
    if (err == NULL)
        g_clear_error (&err);
    else
        min = (1.0 * val) / div;
    
    /* see if the admin locked down the max value */
    strcpy (p, "max");
    val = gconf_client_get_int (gconf, mkey, &err);
    if (err == NULL)
        g_clear_error (&err);
    else
        max = (1.0 * val) / div;
    
    gtk_spin_button_set_range (spin, min, max);
    
    /* get the value */
    val = gconf_client_get_int (gconf, key, NULL);
    gtk_spin_button_set_value (spin, (1.0 * val) / div);
    
    if (value_changed)
        g_signal_connect (spin, "value-changed", value_changed, user_data);
    
    if (!gconf_client_key_is_writable (gconf, key, NULL))
        gtk_widget_set_sensitive ((GtkWidget *) spin, FALSE);
}

static void
toggle_button_init (GtkToggleButton *toggle, GConfClient *gconf, const char *key, int not, GCallback toggled, void *user_data)
{
    gboolean bool;
    
    bool = gconf_client_get_bool (gconf, key, NULL);
    gtk_toggle_button_set_active (toggle, not ? !bool : bool);
    
    if (toggled)
        g_signal_connect (toggle, "toggled", toggled, user_data);
    
    if (!gconf_client_key_is_writable (gconf, key, NULL))
        gtk_widget_set_sensitive ((GtkWidget *) toggle, FALSE);
}

static void
em_mailer_prefs_construct (EMMailerPrefs *prefs)
{
    GSList *list, *header_config_list, *header_add_list, *p;
    GHashTable *default_header_hash;
    GtkWidget *toplevel, *menu;
    GtkTreeSelection *selection;
    GtkCellRenderer *renderer;
    GtkTreeIter iter;
    char *font, *buf;
    GladeXML *gui;
    gboolean locked, check_incoming;
    int val, i;
    
    gui = glade_xml_new (EVOLUTION_GLADEDIR "/mail-config.glade", "preferences_tab", NULL);
    prefs->gui = gui;
    
    /* get our toplevel widget */
    toplevel = glade_xml_get_widget (gui, "toplevel");
    
    /* reparent */
    gtk_widget_ref (toplevel);
    gtk_container_remove (GTK_CONTAINER (toplevel->parent), toplevel);
    gtk_container_add (GTK_CONTAINER (prefs), toplevel);
    gtk_widget_unref (toplevel);
    
    /* General tab */
    
    /* Message Display */
    prefs->timeout_toggle = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "chkMarkTimeout"));
    toggle_button_init (prefs->timeout_toggle, prefs->gconf,
                "/apps/evolution/mail/display/mark_seen",
                FALSE, G_CALLBACK (settings_changed), prefs);
    
    prefs->timeout = GTK_SPIN_BUTTON (glade_xml_get_widget (gui, "spinMarkTimeout"));
    spin_button_init (prefs->timeout, prefs->gconf,
              "/apps/evolution/mail/display/mark_seen_timeout",
              1000.0, G_CALLBACK (settings_changed), prefs);
    
    prefs->charset = GTK_OPTION_MENU (glade_xml_get_widget (gui, "omenuCharset"));
    buf = gconf_client_get_string (prefs->gconf, "/apps/evolution/mail/display/charset", NULL);
    menu = e_charset_picker_new (buf && *buf ? buf : e_iconv_locale_charset ());
    gtk_option_menu_set_menu (prefs->charset, GTK_WIDGET (menu));
    option_menu_connect (prefs->charset, prefs);
    if (!gconf_client_key_is_writable (prefs->gconf, "/apps/evolution/mail/display/charset", NULL))
        gtk_widget_set_sensitive ((GtkWidget *) prefs->charset, FALSE);
    g_free (buf);
    
    prefs->citation_highlight = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "chkHighlightCitations"));
    toggle_button_init (prefs->citation_highlight, prefs->gconf,
                "/apps/evolution/mail/display/mark_citations",
                FALSE, G_CALLBACK (settings_changed), prefs);
    
    prefs->citation_color = GNOME_COLOR_PICKER (glade_xml_get_widget (gui, "colorpickerHighlightCitations"));
    buf = gconf_client_get_string (prefs->gconf, "/apps/evolution/mail/display/citation_colour", NULL);
    colorpicker_set_color (prefs->citation_color, buf ? buf : "#737373");
    g_signal_connect (prefs->citation_color, "color-set", G_CALLBACK (color_set), prefs);
    if (!gconf_client_key_is_writable (prefs->gconf, "/apps/evolution/mail/display/citation_colour", NULL))
        gtk_widget_set_sensitive ((GtkWidget *) prefs->citation_color, FALSE);
    g_free (buf);
    
    /* Deleting Mail */
    prefs->empty_trash = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "chkEmptyTrashOnExit"));
    toggle_button_init (prefs->empty_trash, prefs->gconf,
                "/apps/evolution/mail/trash/empty_on_exit",
                FALSE, G_CALLBACK (settings_changed), prefs);
    
    prefs->confirm_expunge = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "chkConfirmExpunge"));
    toggle_button_init (prefs->confirm_expunge, prefs->gconf,
                "/apps/evolution/mail/prompts/expunge",
                FALSE, G_CALLBACK (settings_changed), prefs);
    
    /* New Mail Notification */
    locked = !gconf_client_key_is_writable (prefs->gconf, "/apps/evolution/mail/notify/type", NULL);
    
    val = gconf_client_get_int (prefs->gconf, "/apps/evolution/mail/notify/type", NULL);
    prefs->notify_not = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "radNotifyNot"));
    gtk_toggle_button_set_active (prefs->notify_not, val == MAIL_CONFIG_NOTIFY_NOT);
    g_signal_connect (prefs->notify_not, "toggled", G_CALLBACK (settings_changed), prefs);
    if (locked)
        gtk_widget_set_sensitive ((GtkWidget *) prefs->notify_not, FALSE);
    
    prefs->notify_beep = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "radNotifyBeep"));
    gtk_toggle_button_set_active (prefs->notify_beep, val == MAIL_CONFIG_NOTIFY_BEEP);
    g_signal_connect (prefs->notify_beep, "toggled", G_CALLBACK (settings_changed), prefs);
    if (locked)
        gtk_widget_set_sensitive ((GtkWidget *) prefs->notify_beep, FALSE);
    
    prefs->notify_play_sound = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "radNotifyPlaySound"));
    gtk_toggle_button_set_active (prefs->notify_play_sound, val == MAIL_CONFIG_NOTIFY_PLAY_SOUND);
    g_signal_connect (prefs->notify_play_sound, "toggled", G_CALLBACK (settings_changed), prefs);
    if (locked)
        gtk_widget_set_sensitive ((GtkWidget *) prefs->notify_play_sound, FALSE);
    
    prefs->notify_sound_file = GNOME_FILE_ENTRY (glade_xml_get_widget (gui, "fileNotifyPlaySound"));
    buf = gconf_client_get_string (prefs->gconf, "/apps/evolution/mail/notify/sound", NULL);
    gtk_entry_set_text (GTK_ENTRY (gnome_file_entry_gtk_entry (prefs->notify_sound_file)), buf ? buf : "");
    g_signal_connect (gnome_file_entry_gtk_entry (prefs->notify_sound_file), "changed",
              G_CALLBACK (settings_changed), prefs);
    if (!gconf_client_key_is_writable (prefs->gconf, "/apps/evolution/mail/notify/sound", NULL))
        gtk_widget_set_sensitive ((GtkWidget *) prefs->notify_sound_file, FALSE);
    g_free (buf);
    
    /* Mail  Fonts */
    font = gconf_client_get_string (prefs->gconf, "/apps/evolution/mail/display/fonts/monospace", NULL);
    prefs->font_fixed = GNOME_FONT_PICKER (glade_xml_get_widget (gui, "radFontFixed"));
    gnome_font_picker_set_font_name (prefs->font_fixed, font);
    g_signal_connect (prefs->font_fixed, "font-set", G_CALLBACK (font_changed), prefs);
    if (!gconf_client_key_is_writable (prefs->gconf, "/apps/evolution/mail/display/fonts/monospace", NULL))
        gtk_widget_set_sensitive ((GtkWidget *) prefs->font_fixed, FALSE);
    
    font = gconf_client_get_string (prefs->gconf, "/apps/evolution/mail/display/fonts/variable", NULL);
    prefs->font_variable = GNOME_FONT_PICKER (glade_xml_get_widget (gui, "radFontVariable"));
    gnome_font_picker_set_font_name (prefs->font_variable, font);
    g_signal_connect (prefs->font_variable, "font-set", G_CALLBACK (font_changed), prefs);
    if (!gconf_client_key_is_writable (prefs->gconf, "/apps/evolution/mail/display/fonts/variable", NULL))
        gtk_widget_set_sensitive ((GtkWidget *) prefs->font_variable, FALSE);
    
    prefs->font_share = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "radFontUseSame"));
    toggle_button_init (prefs->font_share, prefs->gconf,
                "/apps/evolution/mail/display/fonts/use_custom",
                TRUE, G_CALLBACK (font_share_changed), prefs);
    font_share_changed (GTK_WIDGET (prefs->font_share), prefs);
    
    /* HTML Mail tab */
    
    /* Loading Images */
    locked = !gconf_client_key_is_writable (prefs->gconf, "/apps/evolution/mail/display/load_http_images", NULL);
    
    val = gconf_client_get_int (prefs->gconf, "/apps/evolution/mail/display/load_http_images", NULL);
    prefs->images_never = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "radImagesNever"));
    gtk_toggle_button_set_active (prefs->images_never, val == MAIL_CONFIG_HTTP_NEVER);
    g_signal_connect (prefs->images_never, "toggled", G_CALLBACK (settings_changed), prefs);
    if (locked)
        gtk_widget_set_sensitive ((GtkWidget *) prefs->images_never, FALSE);
    
    prefs->images_sometimes = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "radImagesSometimes"));
    gtk_toggle_button_set_active (prefs->images_sometimes, val == MAIL_CONFIG_HTTP_SOMETIMES);
    g_signal_connect (prefs->images_sometimes, "toggled", G_CALLBACK (settings_changed), prefs);
    if (locked)
        gtk_widget_set_sensitive ((GtkWidget *) prefs->images_sometimes, FALSE);
    
    prefs->images_always = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "radImagesAlways"));
    gtk_toggle_button_set_active (prefs->images_always, val == MAIL_CONFIG_HTTP_ALWAYS);
    g_signal_connect (prefs->images_always, "toggled", G_CALLBACK (settings_changed), prefs);
    if (locked)
        gtk_widget_set_sensitive ((GtkWidget *) prefs->images_always, FALSE);
    
    prefs->show_animated = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "chkShowAnimatedImages"));
    toggle_button_init (prefs->show_animated, prefs->gconf,
                "/apps/evolution/mail/display/animate_images",
                FALSE, G_CALLBACK (settings_changed), prefs);
    
    prefs->prompt_unwanted_html = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "chkPromptWantHTML"));
    toggle_button_init (prefs->prompt_unwanted_html, prefs->gconf,
                "/apps/evolution/mail/prompts/unwanted_html",
                FALSE, G_CALLBACK (settings_changed), prefs);
    
    /* Labels... */
    locked = !gconf_client_key_is_writable (prefs->gconf, "/apps/evolution/mail/labels", NULL);
    i = 0;
    list = mail_config_get_labels ();
    while (list != NULL && i < 5) {
        MailConfigLabel *label;
        char *widget_name;
        
        label = list->data;
        
        widget_name = g_strdup_printf ("txtLabel%d", i);
        prefs->labels[i].name = GTK_ENTRY (glade_xml_get_widget (gui, widget_name));
        gtk_widget_set_sensitive ((GtkWidget *) prefs->labels[i].name, !locked);
        g_free (widget_name);
        
        widget_name = g_strdup_printf ("colorLabel%d", i);
        prefs->labels[i].color = GNOME_COLOR_PICKER (glade_xml_get_widget (gui, widget_name));
        gtk_widget_set_sensitive ((GtkWidget *) prefs->labels[i].color, !locked);
        g_free (widget_name);
        
        gtk_entry_set_text (prefs->labels[i].name, label->name);
        g_signal_connect (prefs->labels[i].name, "changed", G_CALLBACK (settings_changed), prefs);
        
        colorpicker_set_color (prefs->labels[i].color, label->colour);
        g_signal_connect (prefs->labels[i].color, "color_set", G_CALLBACK (color_set), prefs);
        
        i++;
        list = list->next;
    }
    
    prefs->restore_labels = GTK_BUTTON (glade_xml_get_widget (gui, "cmdRestoreLabels"));
    gtk_widget_set_sensitive ((GtkWidget *) prefs->restore_labels, !locked);
    g_signal_connect (prefs->restore_labels, "clicked", G_CALLBACK (restore_labels_clicked), prefs);
    
    /* headers */
    locked = !gconf_client_key_is_writable (prefs->gconf, "/apps/evolution/mail/display/headers", NULL);
    
    prefs->add_header = GTK_BUTTON (glade_xml_get_widget (gui, "cmdHeadersAdd"));
    gtk_widget_set_sensitive ((GtkWidget *) prefs->add_header, !locked);
    
    prefs->remove_header = GTK_BUTTON (glade_xml_get_widget (gui, "cmdHeadersRemove"));
    gtk_widget_set_sensitive ((GtkWidget *) prefs->remove_header, !locked);
    
    prefs->entry_header = GTK_ENTRY (glade_xml_get_widget (gui, "txtHeaders"));
    gtk_widget_set_sensitive ((GtkWidget *) prefs->entry_header, !locked);
    
    prefs->header_list = GTK_TREE_VIEW (glade_xml_get_widget (gui, "treeHeaders"));
    gtk_widget_set_sensitive ((GtkWidget *) prefs->header_list, !locked);
    
    selection = gtk_tree_view_get_selection (prefs->header_list);
    g_signal_connect (selection, "changed", G_CALLBACK (emmp_header_list_row_selected), prefs);
    g_signal_connect (prefs->entry_header, "changed", G_CALLBACK (emmp_header_entry_changed), prefs);
    g_signal_connect (prefs->entry_header, "activate", G_CALLBACK (emmp_header_add_header), prefs);
    /* initialise the tree with appropriate headings */
    prefs->header_list_store = gtk_list_store_newv (HEADER_LIST_N_COLUMNS, col_types);
    g_signal_connect (prefs->add_header, "clicked", G_CALLBACK (emmp_header_add_header), prefs);
    g_signal_connect (prefs->remove_header, "clicked", G_CALLBACK (emmp_header_remove_header), prefs);
    gtk_tree_view_set_model (prefs->header_list, GTK_TREE_MODEL (prefs->header_list_store));
    
    renderer = gtk_cell_renderer_toggle_new ();
    g_object_set (renderer, "activatable", TRUE, NULL);
    g_signal_connect (renderer, "toggled", G_CALLBACK (emmp_header_list_enabled_toggled), prefs);
        gtk_tree_view_insert_column_with_attributes (GTK_TREE_VIEW (prefs->header_list), -1, 
                             "Enabled", renderer,
                             "active", HEADER_LIST_ENABLED_COLUMN, 
                             NULL);
    renderer = gtk_cell_renderer_text_new ();
    gtk_tree_view_insert_column_with_attributes (GTK_TREE_VIEW (prefs->header_list), -1, 
                             "Name", renderer,
                             "text", HEADER_LIST_NAME_COLUMN, 
                             NULL);
    
    /* populated the listview with entries; firstly we add all the default headers, and then 
       we add read header configuration out of gconf. If a header in gconf is a default header, 
       we update the enabled flag accordingly
    */
    header_add_list = NULL;
    default_header_hash = g_hash_table_new (g_str_hash, g_str_equal);
    for (i = 0; i < sizeof (default_headers) / sizeof (default_headers[0]); i++) {
        struct _EMMailerPrefsHeader *h;
        
        h = g_malloc (sizeof (struct _EMMailerPrefsHeader));
        h->is_default = TRUE;
        h->name = g_strdup (default_headers[i].name);
        if (g_ascii_strcasecmp (default_headers[i].name, EM_FORMAT_HEADER_XMAILER) == 0)
            h->enabled = FALSE;
        else
            h->enabled = TRUE;
        g_hash_table_insert (default_header_hash, (gpointer) default_headers[i].name, h);
        header_add_list = g_slist_append (header_add_list, h);
    }
    
    /* read stored headers from gconf */
    header_config_list = gconf_client_get_list (prefs->gconf, "/apps/evolution/mail/display/headers", GCONF_VALUE_STRING, NULL);
    p = header_config_list;
    while (p) {
        struct _EMMailerPrefsHeader *h, *def;
        char *xml = (char *) p->data;
        
        h = em_mailer_prefs_header_from_xml (xml);
        if (h) {
            def = g_hash_table_lookup (default_header_hash, h->name);
            if (def) {
                def->enabled = h->enabled;
                em_mailer_prefs_header_free (h);
            } else {
                h->is_default = FALSE;
                header_add_list = g_slist_append (header_add_list, h);
            }
        }
        
        p = p->next;
    }
    
    g_hash_table_destroy (default_header_hash);
    g_slist_foreach (header_config_list, (GFunc) g_free, NULL);
    g_slist_free (header_config_list);
    
    p = header_add_list;
    while (p) {
        struct _EMMailerPrefsHeader *h = (struct _EMMailerPrefsHeader *) p->data;
        const char *name;
        
        if (g_ascii_strcasecmp (h->name, EM_FORMAT_HEADER_XMAILER) == 0)
            name = _("Mailer");
        else
            name = _(h->name);
        
        gtk_list_store_append (prefs->header_list_store, &iter);
        gtk_list_store_set (prefs->header_list_store, &iter, 
                    HEADER_LIST_NAME_COLUMN, name, 
                    HEADER_LIST_ENABLED_COLUMN, h->enabled, 
                    HEADER_LIST_IS_DEFAULT_COLUMN, h->is_default, 
                    HEADER_LIST_HEADER_COLUMN, h->name, 
                    -1);
        
        em_mailer_prefs_header_free (h);
        p = p->next;
    }
    
    g_slist_free (header_add_list);
    emmp_header_remove_sensitivity (prefs);
    
    /* Junk prefs */
    prefs->check_incoming_imap = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "chkDoNotCheckIMAP"));
    toggle_button_init (prefs->check_incoming_imap, prefs->gconf,
                "/apps/evolution/mail/junk/sa/check_incoming_imap",
                TRUE, G_CALLBACK (settings_changed), prefs);
    
    prefs->check_incoming = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "chkCheckIncomingMail"));
    toggle_button_init (prefs->check_incoming, prefs->gconf,
                "/apps/evolution/mail/junk/sa/check_incoming",
                FALSE, G_CALLBACK (settings_changed), prefs);
    
    check_incoming = gtk_toggle_button_get_active (prefs->check_incoming);
    if (!gtk_toggle_button_get_active (prefs->check_incoming))
        gtk_widget_set_sensitive ((GtkWidget *) prefs->check_incoming_imap, FALSE);
    
    prefs->sa_local_tests_only = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "chkSALocalTestsOnly"));
    toggle_button_init (prefs->sa_local_tests_only, prefs->gconf,
                "/apps/evolution/mail/junk/sa/local_only",
                FALSE, G_CALLBACK (settings_changed), prefs);
    
    prefs->sa_use_daemon = GTK_TOGGLE_BUTTON (glade_xml_get_widget (gui, "chkSAUseDaemon"));
    toggle_button_init (prefs->sa_use_daemon, prefs->gconf,
                "/apps/evolution/mail/junk/sa/use_daemon",
                FALSE, G_CALLBACK (settings_changed), prefs);
}

GtkWidget *
em_mailer_prefs_new (void)
{
    EMMailerPrefs *new;
    
    new = (EMMailerPrefs *) g_object_new (em_mailer_prefs_get_type (), NULL);
    em_mailer_prefs_construct (new);
    
    return (GtkWidget *) new;
}


void
em_mailer_prefs_apply (EMMailerPrefs *prefs)
{
    GtkWidget *entry, *menu;
    char *string, buf[20];
    const char *cstring;
    GSList *list, *l, *n;
    guint32 rgb;
    int i, val;
    GtkTreeIter iter;
    gboolean valid;
    GSList *header_list;
    
    /* General tab */
    
    /* Message Display */
    gconf_client_set_bool (prefs->gconf, "/apps/evolution/mail/display/mark_seen",
                   gtk_toggle_button_get_active (prefs->timeout_toggle), NULL);
    
    val = (int) (gtk_spin_button_get_value (prefs->timeout) * 1000.0);
    gconf_client_set_int (prefs->gconf, "/apps/evolution/mail/display/mark_seen_timeout", val, NULL);
    
    menu = gtk_option_menu_get_menu (prefs->charset);
    if (!(string = e_charset_picker_get_charset (menu)))
        string = g_strdup (e_iconv_locale_charset ());
    
    gconf_client_set_string (prefs->gconf, "/apps/evolution/mail/display/charset", string, NULL);
    g_free (string);
    
    gconf_client_set_bool (prefs->gconf, "/apps/evolution/mail/display/mark_citations",
                   gtk_toggle_button_get_active (prefs->citation_highlight), NULL);
    
    rgb = colorpicker_get_color (prefs->citation_color);
    sprintf (buf,"#%06x", rgb & 0xffffff);
    gconf_client_set_string (prefs->gconf, "/apps/evolution/mail/display/citation_colour", buf, NULL);
    
    /* Deleting Mail */
    gconf_client_set_bool (prefs->gconf, "/apps/evolution/mail/trash/empty_on_exit",
                   gtk_toggle_button_get_active (prefs->empty_trash), NULL);
    
    gconf_client_set_bool (prefs->gconf, "/apps/evolution/mail/prompts/expunge",
                   gtk_toggle_button_get_active (prefs->confirm_expunge), NULL);
    
    /* New Mail Notification */
    if (gtk_toggle_button_get_active (prefs->notify_not))
        val = MAIL_CONFIG_NOTIFY_NOT;
    else if (gtk_toggle_button_get_active (prefs->notify_beep))
        val = MAIL_CONFIG_NOTIFY_BEEP;
    else
        val = MAIL_CONFIG_NOTIFY_PLAY_SOUND;
    
    gconf_client_set_int (prefs->gconf, "/apps/evolution/mail/notify/type", val, NULL);
    
    entry = gnome_file_entry_gtk_entry (GNOME_FILE_ENTRY (prefs->notify_sound_file));
    cstring = gtk_entry_get_text (GTK_ENTRY (entry));
    gconf_client_set_string (prefs->gconf, "/apps/evolution/mail/notify/sound", cstring, NULL);
    
    /* HTML Mail */
    if (gtk_toggle_button_get_active (prefs->images_always))
        val = MAIL_CONFIG_HTTP_ALWAYS;
    else if (gtk_toggle_button_get_active (prefs->images_sometimes))
        val = MAIL_CONFIG_HTTP_SOMETIMES;
    else
        val = MAIL_CONFIG_HTTP_NEVER;
    
    gconf_client_set_int (prefs->gconf, "/apps/evolution/mail/display/load_http_images", val, NULL);
    
    gconf_client_set_string (prefs->gconf, "/apps/evolution/mail/display/fonts/variable",
                 gnome_font_picker_get_font_name (prefs->font_variable), NULL);
    gconf_client_set_string (prefs->gconf, "/apps/evolution/mail/display/fonts/monospace",
                 gnome_font_picker_get_font_name (prefs->font_fixed), NULL);
    gconf_client_set_bool (prefs->gconf, "/apps/evolution/mail/display/fonts/use_custom",
                   !gtk_toggle_button_get_active (prefs->font_share), NULL);
    gconf_client_set_bool (prefs->gconf, "/apps/evolution/mail/display/animate_images",
                   gtk_toggle_button_get_active (prefs->show_animated), NULL);
    
    gconf_client_set_bool (prefs->gconf, "/apps/evolution/mail/prompts/unwanted_html",
                   gtk_toggle_button_get_active (prefs->prompt_unwanted_html), NULL);
    
    /* Labels and Colours */
    list = NULL;
    for (i = 4; i >= 0; i--) {
        cstring = gtk_entry_get_text (prefs->labels[i].name);
        rgb = colorpicker_get_color (prefs->labels[i].color);
        string = g_strdup_printf ("%s:#%06x", cstring, rgb & 0xffffff);
        list = g_slist_prepend (list, string);
    }
    
    gconf_client_set_list (prefs->gconf, "/apps/evolution/mail/labels", GCONF_VALUE_STRING, list, NULL);
    
    l = list;
    while (l != NULL) {
        n = l->next;
        g_free (l->data);
        g_slist_free_1 (l);
        l = n;
    }
    
    /* Headers */
    header_list = NULL;
    valid = gtk_tree_model_get_iter_first (GTK_TREE_MODEL (prefs->header_list_store), &iter);
    while (valid) {
        struct _EMMailerPrefsHeader h;
        gboolean enabled;
        char *xml;
        
        gtk_tree_model_get (GTK_TREE_MODEL (prefs->header_list_store), &iter, 
                    HEADER_LIST_HEADER_COLUMN, &h.name, 
                    HEADER_LIST_ENABLED_COLUMN, &enabled, 
                    -1);
        h.enabled = enabled;
        
        if ((xml = em_mailer_prefs_header_to_xml (&h)))
            header_list = g_slist_append (header_list, xml);
        
        valid = gtk_tree_model_iter_next (GTK_TREE_MODEL (prefs->header_list_store), &iter);
    }
    
    gconf_client_set_list (prefs->gconf, "/apps/evolution/mail/display/headers", GCONF_VALUE_STRING, header_list, NULL);
    g_slist_foreach (header_list, (GFunc) g_free, NULL);
    g_slist_free (header_list);
    
    /* junk prefs */
    gconf_client_set_bool (prefs->gconf, "/apps/evolution/mail/junk/check_incoming",
                   gtk_toggle_button_get_active (prefs->check_incoming), NULL);
    gconf_client_set_bool (prefs->gconf, "/apps/evolution/mail/junk/check_incoming_imap",
                   !gtk_toggle_button_get_active (prefs->check_incoming_imap), NULL);
    gconf_client_set_bool (prefs->gconf, "/apps/evolution/mail/junk/sa/local_only",
                   gtk_toggle_button_get_active (prefs->sa_local_tests_only), NULL);
    gconf_client_set_bool (prefs->gconf, "/apps/evolution/mail/junk/sa/use_daemon",
                   gtk_toggle_button_get_active (prefs->sa_use_daemon), NULL);
    
    gconf_client_suggest_sync (prefs->gconf, NULL);
}

static struct _EMMailerPrefsHeader *
emmp_header_from_xmldoc (xmlDocPtr doc)
{
    struct _EMMailerPrefsHeader *h;
    xmlNodePtr root;
    xmlChar *name;
    
    if (doc == NULL)
        return NULL;
    
    root = doc->children;
    if (strcmp (root->name, "header") != 0)
        return NULL;
    
    name = xmlGetProp (root, "name");
    if (name == NULL)
        return NULL;
    
    h = g_malloc0 (sizeof (struct _EMMailerPrefsHeader));
    h->name = g_strdup (name);
    xmlFree (name);
    
    if (xmlHasProp (root, "enabled"))
        h->enabled = 1;
    else
        h->enabled = 0;
    
    return h;
}

/**
 * em_mailer_prefs_header_from_xml
 * @xml: XML configuration data
 *
 * Parses passed XML data, which should be of 
 * the format <header name="foo" enabled />, and 
 * returns a EMMailerPrefs structure, or NULL if there 
 * is an error.
 **/
struct _EMMailerPrefsHeader *
em_mailer_prefs_header_from_xml (const char *xml)
{
    struct _EMMailerPrefsHeader *header;
    xmlDocPtr doc;
    
    if (!(doc = xmlParseDoc ((char *) xml)))
        return NULL;
    
    header = emmp_header_from_xmldoc (doc);
    xmlFreeDoc (doc);
    
    return header;
}

/**
 * em_mailer_prefs_header_free
 * @header: header to free
 *
 * Frees the memory associated with the passed header 
 * structure.
 */
void
em_mailer_prefs_header_free (struct _EMMailerPrefsHeader *header)
{
    if (header == NULL)
        return;
    
    g_free (header->name);
    g_free (header);
}

/**
 * em_mailer_prefs_header_to_xml
 * @header: header from which to generate XML
 *
 * Returns the passed header as a XML structure, 
 * or NULL on error
 */
char *
em_mailer_prefs_header_to_xml (struct _EMMailerPrefsHeader *header)
{
    xmlDocPtr doc;
    xmlNodePtr root;
    xmlChar *xml;
    char *out;
    int size;
    
    g_return_val_if_fail (header != NULL, NULL);
    g_return_val_if_fail (header->name != NULL, NULL);
    
    doc = xmlNewDoc ("1.0");
    
    root = xmlNewDocNode (doc, NULL, "header", NULL);
    xmlSetProp (root, "name", header->name);
    if (header->enabled)
        xmlSetProp (root, "enabled", NULL);
    
    xmlDocSetRootElement (doc, root);
    xmlDocDumpMemory (doc, &xml, &size);
    xmlFreeDoc (doc);
    
    out = g_malloc (size + 1);
    memcpy (out, xml, size);
    out[size] = '\0';
    xmlFree (xml);
    
    return out;
}