Uses custom hash/equals functions so that we can actually fetch equivalent FileDatas...
[geeqie.git] / src / ui_tree_edit.c
1 /*
2  * Copyright (C) 2004 John Ellis
3  * Copyright (C) 2008 - 2016 The Geeqie Team
4  *
5  * Author: John Ellis
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License along
18  * with this program; if not, write to the Free Software Foundation, Inc.,
19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20  */
21
22 #ifdef HAVE_CONFIG_H
23 #  include "config.h"
24 #endif
25 #include "intl.h"
26
27 #include <stdio.h>
28 #include <stdlib.h>
29 #include <string.h>
30
31 #include <gtk/gtk.h>
32 #include <gdk/gdkkeysyms.h>
33
34 #include "compat.h"
35
36 #include "ui_tree_edit.h"
37
38 /*
39  *-------------------------------------------------------------------
40  * cell popup editor
41  *-------------------------------------------------------------------
42  */
43
44 static void tree_edit_close(TreeEditData *ted)
45 {
46         gtk_grab_remove(ted->window);
47         gdk_keyboard_ungrab(GDK_CURRENT_TIME);
48         gdk_pointer_ungrab(GDK_CURRENT_TIME);
49
50         gtk_widget_destroy(ted->window);
51
52         g_free(ted->old_name);
53         g_free(ted->new_name);
54         gtk_tree_path_free(ted->path);
55
56         g_free(ted);
57 }
58
59 static void tree_edit_do(TreeEditData *ted)
60 {
61         ted->new_name = g_strdup(gtk_entry_get_text(GTK_ENTRY(ted->entry)));
62
63         if (strcmp(ted->new_name, ted->old_name) != 0)
64                 {
65                 if (ted->edit_func)
66                         {
67                         if (ted->edit_func(ted, ted->old_name, ted->new_name, ted->edit_data))
68                                 {
69                                 /* hmm, should the caller be required to set text instead ? */
70                                 }
71                         }
72                 }
73 }
74
75 static gboolean tree_edit_click_end_cb(GtkWidget *widget, GdkEventButton *event, gpointer data)
76 {
77         TreeEditData *ted = data;
78
79         tree_edit_do(ted);
80         tree_edit_close(ted);
81
82         return TRUE;
83 }
84
85 static gboolean tree_edit_click_cb(GtkWidget *widget, GdkEventButton *event, gpointer data)
86 {
87         TreeEditData *ted = data;
88         GdkWindow *window = gtk_widget_get_window(ted->window);
89
90         gint x, y;
91         gint w, h;
92
93         gint xr, yr;
94
95         xr = (gint)event->x_root;
96         yr = (gint)event->y_root;
97
98         gdk_window_get_origin(window, &x, &y);
99         w = gdk_window_get_width(window);
100         h = gdk_window_get_height(window);
101
102         if (xr < x || yr < y || xr > x + w || yr > y + h)
103                 {
104                 /* gobble the release event, so it does not propgate to an underlying widget */
105                 g_signal_connect(G_OBJECT(ted->window), "button_release_event",
106                                  G_CALLBACK(tree_edit_click_end_cb), ted);
107                 return TRUE;
108                 }
109         return FALSE;
110 }
111
112 static gboolean tree_edit_key_press_cb(GtkWidget *widget, GdkEventKey *event, gpointer data)
113 {
114         TreeEditData *ted = data;
115
116         switch (event->keyval)
117                 {
118                 case GDK_KEY_Return:
119                 case GDK_KEY_KP_Enter:
120                 case GDK_KEY_Tab:               /* ok, we are going to intercept the focus change
121                                            from keyboard and act like return was hit */
122                 case GDK_KEY_ISO_Left_Tab:
123                 case GDK_KEY_Up:
124                 case GDK_KEY_Down:
125                 case GDK_KEY_KP_Up:
126                 case GDK_KEY_KP_Down:
127                 case GDK_KEY_KP_Left:
128                 case GDK_KEY_KP_Right:
129                         tree_edit_do(ted);
130                         tree_edit_close(ted);
131                         break;
132                 case GDK_KEY_Escape:
133                         tree_edit_close(ted);
134                         break;
135                 default:
136                         break;
137                 }
138
139         return FALSE;
140 }
141
142 static gboolean tree_edit_by_path_idle_cb(gpointer data)
143 {
144         TreeEditData *ted = data;
145         GdkRectangle rect;
146         gint x, y, w, h;        /* geometry of cell within tree */
147         gint wx, wy;            /* geometry of tree from root window */
148         gint sx, sw;
149
150         gtk_tree_view_get_cell_area(ted->tree, ted->path, ted->column, &rect);
151
152         x = rect.x;
153         y = rect.y;
154         w = rect.width + 4;
155         h = rect.height + 4;
156
157         if (gtk_tree_view_column_cell_get_position(ted->column, ted->cell, &sx, &sw))
158                 {
159                 x += sx;
160                 w = MAX(w - sx, sw);
161                 }
162
163         gdk_window_get_origin(gtk_tree_view_get_bin_window(ted->tree), &wx, &wy);
164
165         x += wx - 2; /* the -val is to 'fix' alignment of entry position */
166         y += wy - 2;
167
168         /* now show it */
169         gtk_widget_set_size_request(ted->window, w, h);
170         gtk_widget_realize(ted->window);
171         gtk_window_move(GTK_WINDOW(ted->window), x, y);
172         gtk_window_resize(GTK_WINDOW(ted->window), w, h);
173         gtk_widget_show(ted->window);
174
175         /* grab it */
176         gtk_widget_grab_focus(ted->entry);
177         /* explicitely set the focus flag for the entry, for some reason on popup windows this
178          * is not set, and causes no edit cursor to appear ( popups not allowed focus? )
179          */
180         gtk_widget_grab_focus(ted->entry);
181         gtk_grab_add(ted->window);
182         gdk_pointer_grab(gtk_widget_get_window(ted->window), TRUE,
183                          GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK | GDK_BUTTON_MOTION_MASK,
184                          NULL, NULL, GDK_CURRENT_TIME);
185         gdk_keyboard_grab(gtk_widget_get_window(ted->window), TRUE, GDK_CURRENT_TIME);
186
187         return FALSE;
188 }
189
190 gboolean tree_edit_by_path(GtkTreeView *tree, GtkTreePath *tpath, gint column, const gchar *text,
191                            gboolean (*edit_func)(TreeEditData *, const gchar *, const gchar *, gpointer), gpointer data)
192 {
193         TreeEditData *ted;
194         GtkTreeViewColumn *tcolumn;
195         GtkCellRenderer *cell = NULL;
196         GList *list;
197         GList *work;
198
199         if (!edit_func) return FALSE;
200         if (!gtk_widget_get_visible(GTK_WIDGET(tree))) return FALSE;
201
202         tcolumn = gtk_tree_view_get_column(tree, column);
203         if (!tcolumn) return FALSE;
204
205         list = gtk_cell_layout_get_cells(GTK_CELL_LAYOUT(tcolumn));
206         work = list;
207         while (work && !cell)
208                 {
209                 cell = work->data;
210                 if (!GTK_IS_CELL_RENDERER_TEXT(cell))
211                         {
212                         cell = NULL;
213                         }
214                 work = work->next;
215                 }
216
217         g_list_free(list);
218         if (!cell) return FALSE;
219
220         if (!text) text = "";
221
222         ted = g_new0(TreeEditData, 1);
223
224         ted->old_name = g_strdup(text);
225
226         ted->edit_func = edit_func;
227         ted->edit_data = data;
228
229         ted->tree = tree;
230         ted->path = gtk_tree_path_copy(tpath);
231         ted->column = tcolumn;
232         ted->cell = cell;
233
234         gtk_tree_view_scroll_to_cell(ted->tree, ted->path, ted->column, FALSE, 0.0, 0.0);
235
236         /* create the window */
237
238         ted->window = gtk_window_new(GTK_WINDOW_POPUP);
239         gtk_window_set_resizable(GTK_WINDOW(ted->window), FALSE);
240         g_signal_connect(G_OBJECT(ted->window), "button_press_event",
241                          G_CALLBACK(tree_edit_click_cb), ted);
242         g_signal_connect(G_OBJECT(ted->window), "key_press_event",
243                          G_CALLBACK(tree_edit_key_press_cb), ted);
244
245         ted->entry = gtk_entry_new();
246         gtk_entry_set_text(GTK_ENTRY(ted->entry), ted->old_name);
247         gtk_editable_select_region(GTK_EDITABLE(ted->entry), 0, strlen(ted->old_name));
248         gtk_container_add(GTK_CONTAINER(ted->window), ted->entry);
249         gtk_widget_show(ted->entry);
250
251         /* due to the fact that gtktreeview scrolls in an idle loop, we cannot
252          * reliably get the cell position until those scroll priority signals are processed
253          */
254         g_idle_add_full(G_PRIORITY_DEFAULT_IDLE - 2, tree_edit_by_path_idle_cb, ted, NULL);
255
256         return TRUE;
257 }
258
259 /*
260  *-------------------------------------------------------------------
261  * tree cell position retrieval
262  *-------------------------------------------------------------------
263  */
264
265 gboolean tree_view_get_cell_origin(GtkTreeView *widget, GtkTreePath *tpath, gint column, gboolean text_cell_only,
266                                    gint *x, gint *y, gint *width, gint *height)
267 {
268         gint x_origin, y_origin;
269         gint x_offset, y_offset;
270         gint header_size;
271         GtkTreeViewColumn *tv_column;
272         GdkRectangle rect;
273
274         tv_column = gtk_tree_view_get_column(widget, column);
275         if (!tv_column || !tpath) return FALSE;
276
277         /* hmm, appears the rect will not account for X scroll, but does for Y scroll
278          * use x_offset instead for X scroll (sigh)
279          */
280         gtk_tree_view_get_cell_area(widget, tpath, tv_column, &rect);
281         gtk_tree_view_convert_tree_to_widget_coords(widget, 0, 0, &x_offset, &y_offset);
282         gdk_window_get_origin(gtk_widget_get_window(GTK_WIDGET(widget)), &x_origin, &y_origin);
283
284         if (gtk_tree_view_get_headers_visible(widget))
285                 {
286                 GtkAllocation allocation;
287 #if GTK_CHECK_VERSION(3,0,0)
288                 gtk_widget_get_allocation(gtk_tree_view_column_get_button(tv_column), &allocation);
289 #else
290                 gtk_widget_get_allocation(tv_column->button, &allocation);
291 #endif
292                 header_size = allocation.height;
293                 }
294         else
295                 {
296                 header_size = 0;
297                 }
298
299         if (text_cell_only)
300                 {
301                 GtkCellRenderer *cell = NULL;
302                 GList *renderers;
303                 GList *work;
304                 gint cell_x;
305                 gint cell_width;
306
307                 renderers = gtk_cell_layout_get_cells(GTK_CELL_LAYOUT(tv_column));
308                 work = renderers;
309                 while (work && !cell)
310                         {
311                         cell = work->data;
312                         work = work->next;
313                         if (!GTK_IS_CELL_RENDERER_TEXT(cell)) cell = NULL;
314                         }
315                 g_list_free(renderers);
316
317                 if (!cell) return FALSE;
318
319                 if (!gtk_tree_view_column_cell_get_position(tv_column, cell, &cell_x, &cell_width))
320                         {
321                         cell_x = 0;
322                         cell_width = rect.width;
323                         }
324                 *x = x_origin + x_offset + rect.x + cell_x;
325                 *width = cell_width;
326                 }
327         else
328                 {
329                 *x = x_origin + x_offset + rect.x;
330                 *width = rect.width;
331                 }
332         *y = y_origin + rect.y + header_size;
333         *height = rect.height;
334         return TRUE;
335 }
336
337 void tree_view_get_cell_clamped(GtkTreeView *widget, GtkTreePath *tpath, gint column, gboolean text_cell_only,
338                                 gint *x, gint *y, gint *width, gint *height)
339 {
340         gint wx, wy, ww, wh;
341         GdkWindow *window;
342
343         window = gtk_widget_get_window(GTK_WIDGET(widget));
344         gdk_window_get_origin(window, &wx, &wy);
345
346         ww = gdk_window_get_width(window);
347         wh = gdk_window_get_height(window);
348
349         if (!tree_view_get_cell_origin(widget, tpath, column, text_cell_only, x,  y, width, height))
350                 {
351                 *x = wx;
352                 *y = wy;
353                 *width = ww;
354                 *height = wh;
355                 return;
356                 }
357
358         *width = MIN(*width, ww);
359         *x = CLAMP(*x, wx, wx + ww - (*width));
360         *y = CLAMP(*y, wy, wy + wh);
361         *height = MIN(*height, wy + wh - (*y));
362 }
363
364 /* an implementation that uses gtk_tree_view_get_visible_range */
365 gint tree_view_row_get_visibility(GtkTreeView *widget, GtkTreeIter *iter, gboolean fully_visible)
366 {
367         GtkTreeModel *store;
368         GtkTreePath *tpath, *start_path, *end_path;
369         gint ret = 0;
370
371         if (!gtk_tree_view_get_visible_range(widget, &start_path, &end_path)) return -1; /* we will most probably scroll down, needed for tree_view_row_make_visible */
372
373         store = gtk_tree_view_get_model(widget);
374         tpath = gtk_tree_model_get_path(store, iter);
375
376         if (fully_visible)
377                 {
378                 if (gtk_tree_path_compare(tpath, start_path) <= 0)
379                         {
380                         ret = -1;
381                         }
382                 else if (gtk_tree_path_compare(tpath, end_path) >= 0)
383                         {
384                         ret = 1;
385                         }
386                 }
387         else
388                 {
389                 if (gtk_tree_path_compare(tpath, start_path) < 0)
390                         {
391                         ret = -1;
392                         }
393                 else if (gtk_tree_path_compare(tpath, end_path) > 0)
394                         {
395                         ret = 1;
396                         }
397                 }
398
399         gtk_tree_path_free(tpath);
400         gtk_tree_path_free(start_path);
401         gtk_tree_path_free(end_path);
402         return ret;
403 }
404
405 gint tree_view_row_make_visible(GtkTreeView *widget, GtkTreeIter *iter, gboolean center)
406 {
407         GtkTreePath *tpath;
408         gint vis;
409
410         vis = tree_view_row_get_visibility(widget, iter, TRUE);
411
412         tpath = gtk_tree_model_get_path(gtk_tree_view_get_model(widget), iter);
413         if (center && vis != 0)
414                 {
415                 gtk_tree_view_scroll_to_cell(widget, tpath, NULL, TRUE, 0.5, 0.0);
416                 }
417         else if (vis < 0)
418                 {
419                 gtk_tree_view_scroll_to_cell(widget, tpath, NULL, TRUE, 0.0, 0.0);
420                 }
421         else if (vis > 0)
422                 {
423                 gtk_tree_view_scroll_to_cell(widget, tpath, NULL, TRUE, 1.0, 0.0);
424                 }
425         gtk_tree_path_free(tpath);
426
427         return vis;
428 }
429
430 gboolean tree_view_move_cursor_away(GtkTreeView *widget, GtkTreeIter *iter, gboolean only_selected)
431 {
432         GtkTreeModel *store;
433         GtkTreePath *tpath;
434         GtkTreePath *fpath;
435         gboolean move = FALSE;
436
437         if (!iter) return FALSE;
438
439         store = gtk_tree_view_get_model(widget);
440         tpath = gtk_tree_model_get_path(store, iter);
441         gtk_tree_view_get_cursor(widget, &fpath, NULL);
442
443         if (fpath && gtk_tree_path_compare(tpath, fpath) == 0)
444                 {
445                 GtkTreeSelection *selection;
446
447                 selection = gtk_tree_view_get_selection(widget);
448
449                 if (!only_selected ||
450                     gtk_tree_selection_path_is_selected(selection, tpath))
451                         {
452                         GtkTreeIter current;
453
454                         current = *iter;
455                         if (gtk_tree_model_iter_next(store, &current))
456                                 {
457                                 gtk_tree_path_next(tpath);
458                                 move = TRUE;
459                                 }
460                         else if (gtk_tree_path_prev(tpath) &&
461                                  gtk_tree_model_get_iter(store, &current, tpath))
462                                 {
463                                 move = TRUE;
464                                 }
465
466                         if (move)
467                                 {
468                                 gtk_tree_view_set_cursor(widget, tpath, NULL, FALSE);
469                                 }
470                         }
471                 }
472
473         gtk_tree_path_free(tpath);
474         if (fpath) gtk_tree_path_free(fpath);
475
476         return move;
477 }
478
479 gint tree_path_to_row(GtkTreePath *tpath)
480 {
481         gint *indices;
482
483         indices = gtk_tree_path_get_indices(tpath);
484         if (indices) return indices[0];
485
486         return -1;
487 }
488
489
490 /*
491  *-------------------------------------------------------------------
492  * color utilities
493  *-------------------------------------------------------------------
494  */
495
496 void shift_color(GdkColor *src, gshort val, gint direction)
497 {
498         gshort cs;
499         static gshort COLOR_MAX = 0xffff;
500
501         if (val == -1)
502                 {
503                 val = STYLE_SHIFT_STANDARD;
504                 }
505         else
506                 {
507                 val = CLAMP(val, 1, 100);
508                 }
509         cs = COLOR_MAX / 100 * val;
510
511         /* up or down ? */
512         if (direction < 0 ||
513             (direction == 0 &&((gint)src->red + (gint)src->green + (gint)src->blue) / 3 > COLOR_MAX / 2))
514                 {
515                 src->red = MAX(0 , src->red - cs);
516                 src->green = MAX(0 , src->green - cs);
517                 src->blue = MAX(0 , src->blue - cs);
518                 }
519         else
520                 {
521                 src->red = MIN(COLOR_MAX, src->red + cs);
522                 src->green = MIN(COLOR_MAX, src->green + cs);
523                 src->blue = MIN(COLOR_MAX, src->blue + cs);
524                 }
525 }
526
527 /* darkens or lightens a style's color for given state
528  * esp. useful for alternating dark/light in (c)lists
529  */
530 void style_shift_color(GtkStyle *style, GtkStateType type, gshort shift_value, gint direction)
531 {
532         if (!style) return;
533
534         shift_color(&style->base[type], shift_value, direction);
535         shift_color(&style->bg[type], shift_value, direction);
536 }
537
538 /*
539  *-------------------------------------------------------------------
540  * auto scroll by mouse position
541  *-------------------------------------------------------------------
542  */
543
544 #define AUTO_SCROLL_DEFAULT_SPEED 100
545 #define AUTO_SCROLL_DEFAULT_REGION 20
546
547 typedef struct _AutoScrollData AutoScrollData;
548 struct _AutoScrollData
549 {
550         guint timer_id; /* event source id */
551         gint region_size;
552         GtkWidget *widget;
553         GtkAdjustment *adj;
554         gint max_step;
555
556         gint (*notify_func)(GtkWidget *, gint, gint, gpointer);
557         gpointer notify_data;
558 };
559
560 void widget_auto_scroll_stop(GtkWidget *widget)
561 {
562         AutoScrollData *sd;
563
564         sd = g_object_get_data(G_OBJECT(widget), "autoscroll");
565         if (!sd) return;
566         g_object_set_data(G_OBJECT(widget), "autoscroll", NULL);
567
568         if (sd->timer_id) g_source_remove(sd->timer_id);
569         g_free(sd);
570 }
571
572 static gboolean widget_auto_scroll_cb(gpointer data)
573 {
574         AutoScrollData *sd = data;
575         GdkWindow *window;
576         gint x, y;
577         gint w, h;
578         gint amt = 0;
579 #if GTK_CHECK_VERSION(3,0,0)
580         GdkDeviceManager *device_manager;
581         GdkDevice *device;
582 #endif
583
584         if (sd->max_step < sd->region_size)
585                 {
586                 sd->max_step = MIN(sd->region_size, sd->max_step + 2);
587                 }
588
589         window = gtk_widget_get_window(sd->widget);
590 #if GTK_CHECK_VERSION(3,0,0)
591         device_manager = gdk_display_get_device_manager(gdk_window_get_display(window));
592         device = gdk_device_manager_get_client_pointer(device_manager);
593         gdk_window_get_device_position(window, device, &x, &y, NULL);
594 #else
595         gdk_window_get_pointer(window, &x, &y, NULL);
596 #endif
597         w = gdk_window_get_width(window);
598         h = gdk_window_get_height(window);
599
600         if (x < 0 || x >= w || y < 0 || y >= h)
601                 {
602                 sd->timer_id = 0;
603                 widget_auto_scroll_stop(sd->widget);
604                 return FALSE;
605                 }
606
607         if (h < sd->region_size * 3)
608                 {
609                 /* height is cramped, nicely divide into three equal regions */
610                 if (y < h / 3 || y > h / 3 * 2)
611                         {
612                         amt = (y < h / 2) ? 0 - ((h / 2) - y) : y - (h / 2);
613                         }
614                 }
615         else if (y < sd->region_size)
616                 {
617                 amt = 0 - (sd->region_size - y);
618                 }
619         else if (y >= h - sd->region_size)
620                 {
621                 amt = y - (h - sd->region_size);
622                 }
623
624         if (amt != 0)
625                 {
626                 amt = CLAMP(amt, 0 - sd->max_step, sd->max_step);
627
628                 if (gtk_adjustment_get_value(sd->adj) != CLAMP(gtk_adjustment_get_value(sd->adj) + amt, gtk_adjustment_get_lower(sd->adj), gtk_adjustment_get_upper(sd->adj) - gtk_adjustment_get_page_size(sd->adj)))
629                         {
630                         /* only notify when scrolling is needed */
631                         if (sd->notify_func && !sd->notify_func(sd->widget, x, y, sd->notify_data))
632                                 {
633                                 sd->timer_id = 0;
634                                 widget_auto_scroll_stop(sd->widget);
635                                 return FALSE;
636                                 }
637
638                         gtk_adjustment_set_value(sd->adj,
639                                 CLAMP(gtk_adjustment_get_value(sd->adj) + amt, gtk_adjustment_get_lower(sd->adj), gtk_adjustment_get_upper(sd->adj) - gtk_adjustment_get_page_size(sd->adj)));
640                         }
641                 }
642
643         return TRUE;
644 }
645
646 gint widget_auto_scroll_start(GtkWidget *widget, GtkAdjustment *v_adj, gint scroll_speed, gint region_size,
647                               gint (*notify_func)(GtkWidget *widget, gint x, gint y, gpointer data), gpointer notify_data)
648 {
649         AutoScrollData *sd;
650
651         if (!widget || !v_adj) return 0;
652         if (g_object_get_data(G_OBJECT(widget), "autoscroll")) return 0;
653         if (scroll_speed < 1) scroll_speed = AUTO_SCROLL_DEFAULT_SPEED;
654         if (region_size < 1) region_size = AUTO_SCROLL_DEFAULT_REGION;
655
656         sd = g_new0(AutoScrollData, 1);
657         sd->widget = widget;
658         sd->adj = v_adj;
659         sd->region_size = region_size;
660         sd->max_step = 1;
661         sd->timer_id = g_timeout_add(scroll_speed, widget_auto_scroll_cb, sd);
662
663         sd->notify_func = notify_func;
664         sd->notify_data = notify_data;
665
666         g_object_set_data(G_OBJECT(widget), "autoscroll", sd);
667
668         return scroll_speed;
669 }
670
671
672 /*
673  *-------------------------------------------------------------------
674  * GList utils
675  *-------------------------------------------------------------------
676  */
677
678 GList *uig_list_insert_link(GList *list, GList *link, gpointer data)
679 {
680         GList *new_list;
681
682         if (!list || link == list) return g_list_prepend(list, data);
683         if (!link) return g_list_append(list, data);
684
685         new_list = g_list_alloc();
686         new_list->data = data;
687
688         if (link->prev)
689                 {
690                 link->prev->next = new_list;
691                 new_list->prev = link->prev;
692                 }
693         else
694                 {
695                 list = new_list;
696                 }
697         link->prev = new_list;
698         new_list->next = link;
699
700         return list;
701 }
702
703 GList *uig_list_insert_list(GList *parent, GList *insert_link, GList *list)
704 {
705         GList *end;
706
707         if (!insert_link) return g_list_concat(parent, list);
708         if (insert_link == parent) return g_list_concat(list, parent);
709         if (!parent) return list;
710         if (!list) return parent;
711
712         end  = g_list_last(list);
713
714         if (insert_link->prev) insert_link->prev->next = list;
715         list->prev = insert_link->prev;
716         insert_link->prev = end;
717         end->next = insert_link;
718
719         return parent;
720 }
721 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */