path: root/src/gui/menus/edition.c

/* Chrysalide - Outil d'analyse de fichiers binaires
 * edition.c - gestion du menu 'Edition'
 *
 * Copyright (C) 2012 Cyrille Bagard
 *
 *  This file is part of Chrysalide.
 *
 *  OpenIDA 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 3 of the License, or
 *  (at your option) any later version.
 *
 *  OpenIDA 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 Place, Suite 330, Boston, MA  02111-1307  USA
 */


#include "edition.h"


#include <assert.h>


#include <i18n.h>


#include "../dialogs/bookmark.h"
#include "../dialogs/goto.h"
#include "../dialogs/gotox.h"
#include "../../analysis/db/items/switcher.h"
#include "../../arch/target.h"
#include "../../gtkext/easygtk.h"
#include "../../gtkext/gtkbufferview.h"



/* Réagit avec le menu "Edition -> Aller à l'adresse...". */
static void mcb_edition_goto(GtkMenuItem *, GMenuBar *);

/* Réagit avec le menu "Edition -> Operande numérique -> ...". */
static void mcb_edition_switch_numeric_operand(GtkMenuItem *, GMenuBar *);

/* Réagit avec le menu "Edition -> Revenir en arrière". */
static void mcb_edition_go_back(GtkMenuItem *, GMenuBar *);

/* Réagit avec le menu "Edition -> Suivre la référence". */
static void mcb_edition_follow_ref(GtkMenuItem *, GMenuBar *);

/* Réagit avec le menu "Edition -> Lister toutes les réfs...". */
static void mcb_edition_list_xrefs(GtkMenuItem *, GMenuBar *);

/* Réagit avec le menu "Edition -> Signets -> Basculer...". */
static void mcb_edition_bookmarks_toggle(GtkMenuItem *, GMenuBar *);

/* Réagit avec le menu "Edition -> Signets -> Effacer tous...". */
static void mcb_edition_bookmarks_delete_all(GtkMenuItem *, GMenuBar *);

/* Réagit avec le menu "Edition -> Commentaires -> Inscrire...". */
static void mcb_edition_comment_enter(GtkMenuItem *, GMenuBar *);

/* Réagit avec le menu "Edition -> Commentaires -> Ins. rep...". */
static void mcb_edition_comment_enter_repeatable(GtkMenuItem *, GMenuBar *);

/* Réagit avec le menu "Edition -> Commentaires -> Ins. av...". */
static void mcb_edition_comment_enter_previous(GtkMenuItem *, GMenuBar *);

/* Réagit avec le menu "Edition -> Commentaires -> Ins. ap...". */
static void mcb_edition_comment_enter_next(GtkMenuItem *, GMenuBar *);



/******************************************************************************
*                                                                             *
*  Paramètres  : ref      = espace de référencement global.                   *
*                accgroup = groupe d'accélérateurs pour les menus.            *
*                bar      = barre de menu parente.                            *
*                                                                             *
*  Description : Construit le menu "Edition".                                 *
*                                                                             *
*  Retour      : Panneau de menus mis en place.                               *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

GtkWidget *build_menu_edition(GObject *ref, GtkAccelGroup *accgroup, GMenuBar *bar)
{
    GtkWidget *result;                      /* Support à retourner         */
    GtkWidget *menubar;                     /* Support pour éléments       */
    GtkWidget *submenuitem;                 /* Sous-élément de menu #1     */
    GtkWidget *deepmenubar;                 /* Support pour éléments #2    */
    GtkWidget *deepmenuitem;                /* Sous-élément de menu #2     */

    result = gtk_menu_item_new_with_mnemonic(_("_Edition"));
    gtk_widget_show(result);

    menubar = gtk_menu_new();
    gtk_menu_item_set_submenu(GTK_MENU_ITEM(result), menubar);

    submenuitem = qck_create_menu_item(NULL, NULL, _("Go to address..."),
                                       G_CALLBACK(mcb_edition_goto), bar);
    add_accelerator_to_menu_item(submenuitem, "<Ctrl>G", accgroup);
    gtk_container_add(GTK_CONTAINER(menubar), submenuitem);

    submenuitem = qck_create_menu_separator();
    gtk_container_add(GTK_CONTAINER(menubar), submenuitem);

    submenuitem = qck_create_menu_item(NULL, NULL, _("Numeric operand"), NULL, NULL);
    gtk_container_add(GTK_CONTAINER(menubar), submenuitem);

    deepmenubar = gtk_menu_new();
    gtk_menu_item_set_submenu(GTK_MENU_ITEM(submenuitem), deepmenubar);

    deepmenuitem = qck_create_menu_item(ref, "mnu_edit_switch_hex", _("Hexadecimal"),
                                        G_CALLBACK(mcb_edition_switch_numeric_operand), bar);
    add_accelerator_to_menu_item(deepmenuitem, "H", accgroup);
    g_object_set_data(G_OBJECT(deepmenuitem), "kind_of_switch", GUINT_TO_POINTER(IOD_HEX));
    gtk_container_add(GTK_CONTAINER(deepmenubar), deepmenuitem);

    deepmenuitem = qck_create_menu_item(ref, "mnu_edit_switch_dec", _("Decimal"),
                                        G_CALLBACK(mcb_edition_switch_numeric_operand), bar);
    add_accelerator_to_menu_item(deepmenuitem, "D", accgroup);
    g_object_set_data(G_OBJECT(deepmenuitem), "kind_of_switch", GUINT_TO_POINTER(IOD_DEC));
    gtk_container_add(GTK_CONTAINER(deepmenubar), deepmenuitem);

    deepmenuitem = qck_create_menu_item(ref, "mnu_edit_switch_oct", _("Octal"),
                                        G_CALLBACK(mcb_edition_switch_numeric_operand), bar);
    add_accelerator_to_menu_item(deepmenuitem, "O", accgroup);
    g_object_set_data(G_OBJECT(deepmenuitem), "kind_of_switch", GUINT_TO_POINTER(IOD_OCT));
    gtk_container_add(GTK_CONTAINER(deepmenubar), deepmenuitem);

    deepmenuitem = qck_create_menu_item(ref, "mnu_edit_switch_bin", _("Binary"),
                                        G_CALLBACK(mcb_edition_switch_numeric_operand), bar);
    add_accelerator_to_menu_item(deepmenuitem, "B", accgroup);
    g_object_set_data(G_OBJECT(deepmenuitem), "kind_of_switch", GUINT_TO_POINTER(IOD_BIN));
    gtk_container_add(GTK_CONTAINER(deepmenubar), deepmenuitem);

    deepmenuitem = qck_create_menu_separator();
    gtk_container_add(GTK_CONTAINER(deepmenubar), deepmenuitem);

    deepmenuitem = qck_create_menu_item(ref, "mnu_edit_switch_def", _("Default"),
                                        G_CALLBACK(mcb_edition_switch_numeric_operand), bar);
    g_object_set_data(G_OBJECT(deepmenuitem), "kind_of_switch", GUINT_TO_POINTER(IOD_COUNT));
    gtk_container_add(GTK_CONTAINER(deepmenubar), deepmenuitem);

    /* Séparation */

    submenuitem = qck_create_menu_separator();
    gtk_container_add(GTK_CONTAINER(menubar), submenuitem);

    /* Déplacements */

    submenuitem = qck_create_menu_item(ref, "mnu_edit_go_back", _("Go back"),
                                       G_CALLBACK(mcb_edition_go_back), bar);
    add_accelerator_to_menu_item(submenuitem, "Escape", accgroup);
    gtk_container_add(GTK_CONTAINER(menubar), submenuitem);

    submenuitem = qck_create_menu_item(ref, "mnu_edit_follow_ref", _("Follow the reference"),
                                       G_CALLBACK(mcb_edition_follow_ref), bar);
    add_accelerator_to_menu_item(submenuitem, "Return", accgroup);
    gtk_container_add(GTK_CONTAINER(menubar), submenuitem);

    submenuitem = qck_create_menu_item(ref, "mnu_edit_list_xrefs", _("List all references leading to..."),
                                       G_CALLBACK(mcb_edition_list_xrefs), bar);
    add_accelerator_to_menu_item(submenuitem, "X", accgroup);
    gtk_container_add(GTK_CONTAINER(menubar), submenuitem);

    /* Séparation */

    submenuitem = qck_create_menu_separator();
    gtk_container_add(GTK_CONTAINER(menubar), submenuitem);

    /* Signets */

    submenuitem = qck_create_menu_item(NULL, NULL, _("Bookmarks"), NULL, NULL);
    gtk_container_add(GTK_CONTAINER(menubar), submenuitem);

    deepmenubar = gtk_menu_new();
    gtk_menu_item_set_submenu(GTK_MENU_ITEM(submenuitem), deepmenubar);

    deepmenuitem = qck_create_menu_item(NULL, NULL, _("Toggle at current location"),
                                        G_CALLBACK(mcb_edition_bookmarks_toggle), bar);
    add_accelerator_to_menu_item(deepmenuitem, "<Ctrl>D", accgroup);
    gtk_container_add(GTK_CONTAINER(deepmenubar), deepmenuitem);

    deepmenuitem = qck_create_menu_item(NULL, NULL, _("Delete all bookmarks"),
                                        G_CALLBACK(mcb_edition_bookmarks_delete_all), bar);
    gtk_container_add(GTK_CONTAINER(deepmenubar), deepmenuitem);

    /* Commentaires */

    submenuitem = qck_create_menu_item(NULL, NULL, _("Comments"), NULL, NULL);
    gtk_container_add(GTK_CONTAINER(menubar), submenuitem);

    deepmenubar = gtk_menu_new();
    gtk_menu_item_set_submenu(GTK_MENU_ITEM(submenuitem), deepmenubar);

    deepmenuitem = qck_create_menu_item(NULL, NULL, _("Enter a comment..."),
                                        G_CALLBACK(mcb_edition_comment_enter), bar);
    add_accelerator_to_menu_item(deepmenuitem, "semicolon", accgroup);
    gtk_container_add(GTK_CONTAINER(deepmenubar), deepmenuitem);

    deepmenuitem = qck_create_menu_item(NULL, NULL, _("Enter a repeatable comment..."),
                                        G_CALLBACK(mcb_edition_comment_enter_repeatable), bar);
    add_accelerator_to_menu_item(deepmenuitem, "colon", accgroup);
    gtk_container_add(GTK_CONTAINER(deepmenubar), deepmenuitem);

    deepmenuitem = qck_create_menu_item(NULL, NULL, _("Enter a comment in the previous line..."),
                                        G_CALLBACK(mcb_edition_comment_enter_previous), bar);
    add_accelerator_to_menu_item(deepmenuitem, "Insert", accgroup);
    gtk_container_add(GTK_CONTAINER(deepmenubar), deepmenuitem);

    deepmenuitem = qck_create_menu_item(NULL, NULL, _("Enter a comment in the next line..."),
                                        G_CALLBACK(mcb_edition_comment_enter_next), bar);
    add_accelerator_to_menu_item(deepmenuitem, "<Shift>Insert", accgroup);
    gtk_container_add(GTK_CONTAINER(deepmenubar), deepmenuitem);

    return result;

}


/******************************************************************************
*                                                                             *
*  Paramètres  : ref    = espace de référencements à consulter.               *
*                vpanel = panneau d'affichage actif ou NULL si aucun.         *
*                addr   = nouvelle adresse du curseur courant.                *
*                                                                             *
*  Description : Met à jour les accès du menu "Edition" selon une position.   *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

void update_access_in_menu_edition(GObject *ref, GtkViewPanel *vpanel, const vmpa2t *addr)
{
    bool state;                             /* Etat principal à considérer */
    gboolean access;                        /* Accès à déterminer          */
    GBufferLine *line;                      /* Ligne de position courante  */
    GBufferSegment *segment;                /* Segment actif s'il existe   */
    GObject *creator;                       /* Créateur à l'orgine du seg. */
    GtkWidget *item;                        /* Elément de menu à traiter   */

    /* Préliminaire */

    if (vpanel == NULL || addr == NULL)
    {
        state = false;
        line = NULL;
        segment = NULL;
    }
    else
        state = gtk_view_panel_get_position(vpanel, &line, &segment);

    if (state)
        creator = g_buffer_segment_get_creator(segment);
    else
        creator = NULL;

    /* Bascule des opérandes numériques */

    access = (state && G_IS_IMM_OPERAND(creator));

    item = GTK_WIDGET(g_object_get_data(ref, "mnu_edit_switch_hex"));
    gtk_widget_set_sensitive(item, access);

    item = GTK_WIDGET(g_object_get_data(ref, "mnu_edit_switch_dec"));
    gtk_widget_set_sensitive(item, access);

    item = GTK_WIDGET(g_object_get_data(ref, "mnu_edit_switch_oct"));
    gtk_widget_set_sensitive(item, access);

    item = GTK_WIDGET(g_object_get_data(ref, "mnu_edit_switch_bin"));
    gtk_widget_set_sensitive(item, access);

    item = GTK_WIDGET(g_object_get_data(ref, "mnu_edit_switch_def"));
    gtk_widget_set_sensitive(item, access);

    /* Suivi de cibles */

    access = (state && (G_IS_TARGET_OPERAND(creator) || G_IS_IMM_OPERAND(creator)));

    item = GTK_WIDGET(g_object_get_data(ref, "mnu_edit_follow_ref"));
    gtk_widget_set_sensitive(item, access);

    access = state;

    item = GTK_WIDGET(g_object_get_data(ref, "mnu_edit_list_xrefs"));
    gtk_widget_set_sensitive(item, access);

    /* Nettoyage et sortie finale */

    if (creator != NULL) g_object_unref(G_OBJECT(creator));

    if (segment != NULL) g_object_unref(G_OBJECT(segment));
    if (line != NULL) g_object_unref(G_OBJECT(line));

}


/******************************************************************************
*                                                                             *
*  Paramètres  : menuitem = élément de menu sélectionné.                      *
*                bar      = barre de menu parente.                            *
*                                                                             *
*  Description : Réagit avec le menu "Edition -> Aller à l'adresse...".       *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void mcb_edition_goto(GtkMenuItem *menuitem, GMenuBar *bar)
{
    GObject *ref;                           /* Espace de référencements    */
    GtkWidget *dialog;                      /* Boîte de dialogue à montrer */
    vmpa2t *addr;                           /* Adresse de destination      */
    GtkViewPanel *vpanel;                   /* Afficheur effectif de code  */

    ref = g_editor_item_get_global_ref(G_EDITOR_ITEM(bar));
    dialog = create_goto_dialog(GTK_WINDOW(ref));

    if (gtk_dialog_run(GTK_DIALOG(dialog)) == GTK_RESPONSE_OK)
    {
        addr = get_address_from_goto_dialog(dialog);

        vpanel = g_editor_item_get_current_view(G_EDITOR_ITEM(bar));
        gtk_view_panel_request_move(vpanel, addr);

        delete_vmpa(addr);

    }

    gtk_widget_destroy(dialog);

}


/******************************************************************************
*                                                                             *
*  Paramètres  : menuitem = élément de menu sélectionné.                      *
*                bar      = barre de menu parente.                            *
*                                                                             *
*  Description : Réagit avec le menu "Edition -> Operande numérique -> ...".  *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void mcb_edition_switch_numeric_operand(GtkMenuItem *menuitem, GMenuBar *bar)
{
    ImmOperandDisplay display;              /* Type de basculement         */
    GEditorItem *editem;                    /* Autre version de la barre   */
    GtkViewPanel *vpanel;                   /* Afficheur effectif de code  */
    GBufferLine *line;                      /* Ligne de position courante  */
    GBufferSegment *segment;                /* Segment actif s'il existe   */
    GObject *creator;                       /* Créateur à l'orgine du seg. */
    GDbSwitcher *switcher;                  /* Bascule à mettre en place   */
    const mrange_t *range;                  /* Emplacement de la ligne     */
    GLoadedBinary *binary;                  /* Binaire en cours d'étude    */
    GArchProcessor *proc;                   /* Propriétaire d'instructions */
    GArchInstruction *instr;                /* Instruction liée à la ligne */

    display = GPOINTER_TO_UINT(g_object_get_data(G_OBJECT(menuitem), "kind_of_switch"));

    editem = G_EDITOR_ITEM(bar);

    vpanel = g_editor_item_get_current_view(editem);

    if (gtk_view_panel_get_position(vpanel, &line, &segment))
    {
        creator = g_buffer_segment_get_creator(segment);
        assert(G_IS_IMM_OPERAND(creator));

        range = g_buffer_line_get_range(line);

        binary = g_editor_item_get_current_binary(editem);
        proc = g_loaded_binary_get_processor(binary);

        instr = g_arch_processor_find_instr_by_address(proc, get_mrange_addr(range));
        assert(instr != NULL);

        switcher = g_db_switcher_new(instr, G_IMM_OPERAND(creator), display);

        g_loaded_binary_add_to_collection(binary, DBF_DISPLAY_SWITCHERS, G_DB_ITEM(switcher));

        g_object_unref(G_OBJECT(proc));

        g_object_unref(creator);

        g_object_unref(G_OBJECT(segment));
        g_object_unref(G_OBJECT(line));

    }

}


/******************************************************************************
*                                                                             *
*  Paramètres  : menuitem = élément de menu sélectionné.                      *
*                bar      = barre de menu parente.                            *
*                                                                             *
*  Description : Réagit avec le menu "Edition -> Revenir en arrière".         *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void mcb_edition_go_back(GtkMenuItem *menuitem, GMenuBar *bar)
{

}


/******************************************************************************
*                                                                             *
*  Paramètres  : menuitem = élément de menu sélectionné.                      *
*                bar      = barre de menu parente.                            *
*                                                                             *
*  Description : Réagit avec le menu "Edition -> Suivre la référence".        *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void mcb_edition_follow_ref(GtkMenuItem *menuitem, GMenuBar *bar)
{
    GtkViewPanel *vpanel;                   /* Afficheur effectif de code  */
    GBufferLine *line;                      /* Ligne de position courante  */
    GBufferSegment *segment;                /* Segment actif s'il existe   */
    GObject *creator;                       /* Créateur à l'orgine du seg. */
    virt_t virt;                            /* Adresse virtuelle           */
    vmpa2t addr;                            /* Adresse de destination      */

    vpanel = g_editor_item_get_current_view(G_EDITOR_ITEM(bar));

    if (gtk_view_panel_get_position(vpanel, &line, &segment))
    {
        creator = g_buffer_segment_get_creator(segment);
        assert(creator != NULL);

        /**
         * On fait le pari de reposer uniquement sur des adresses virtuelles !
         * A changer dans un futur ?
         */

        virt = VMPA_NO_VIRTUAL;

        if (G_IS_TARGET_OPERAND(creator))
            virt = g_target_operand_get_addr(G_TARGET_OPERAND(creator));

        else if (G_IS_IMM_OPERAND(creator))
        {
            if (!g_imm_operand_to_virt_t(G_IMM_OPERAND(creator), &virt))
                virt = VMPA_NO_VIRTUAL;
        }

        if (virt != VMPA_NO_VIRTUAL)
        {
            init_vmpa(&addr, VMPA_NO_PHYSICAL, virt);
            gtk_view_panel_request_move(vpanel, &addr);
        }

        g_object_unref(creator);

        g_object_unref(G_OBJECT(segment));
        g_object_unref(G_OBJECT(line));

    }

}


/******************************************************************************
*                                                                             *
*  Paramètres  : menuitem = élément de menu sélectionné.                      *
*                bar      = barre de menu parente.                            *
*                                                                             *
*  Description : Réagit avec le menu "Edition -> Lister toutes les réfs...".  *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void mcb_edition_list_xrefs(GtkMenuItem *menuitem, GMenuBar *bar)
{
    GtkViewPanel *vpanel;                   /* Afficheur effectif de code  */
    GBufferLine *line;                      /* Ligne de position courante  */
    const mrange_t *range;                  /* Couverture en mémoire       */
    GLoadedBinary *binary;                  /* Représentation binaire      */
    GArchProcessor *proc;                   /* Processeur de l'architecture*/
    GArchInstruction *list;                 /* Ensemble des instructions   */
    GArchInstruction *instr;                /* Point de croisements        */
    GObject *ref;                           /* Espace de référencements    */
    GtkWidget *dialog;                      /* Boîte de dialogue à montrer */
    vmpa2t *addr;                           /* Adresse de destination      */

    vpanel = g_editor_item_get_current_view(G_EDITOR_ITEM(bar));

    if (gtk_view_panel_get_position(vpanel, &line, NULL))
    {
        range = g_buffer_line_get_range(line);

        binary = g_editor_item_get_current_binary(G_EDITOR_ITEM(bar));
        proc = g_loaded_binary_get_processor(binary);
        list = g_arch_processor_get_disassembled_instructions(proc);

        /**
         * On ne peut pas se reposer sur l'espace couvert par une ligne, car il peut
         * être de taille nulle (cas d'une étiquette, par exemple), à la différence
         * de la taille d'une instruction.
         *
         * Il n'est donc pas judicieux de rechercher cette instruction avec
         * un appel de type :
         *
         *    instr = g_arch_instruction_find_by_range(list, range);
         *
         * Il faut ainsi être plus souple.
         */
        instr = g_arch_instruction_find_by_address(list, get_mrange_addr(range), true);

        ref = g_editor_item_get_global_ref(G_EDITOR_ITEM(bar));

        dialog = create_gotox_dialog_for_cross_references(GTK_WINDOW(ref), binary, instr, true);

        if (gtk_dialog_run(GTK_DIALOG(dialog)) == GTK_RESPONSE_OK)
        {
            addr = get_address_from_gotox_dialog(dialog);

            gtk_view_panel_request_move(vpanel, addr);

            delete_vmpa(addr);

        }

        gtk_widget_destroy(dialog);

        g_object_unref(G_OBJECT(proc));

        g_object_unref(G_OBJECT(line));

    }

}


/******************************************************************************
*                                                                             *
*  Paramètres  : menuitem = élément de menu sélectionné.                      *
*                bar      = barre de menu parente.                            *
*                                                                             *
*  Description : Réagit avec le menu "Edition -> Signets -> Basculer...".     *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void mcb_edition_bookmarks_toggle(GtkMenuItem *menuitem, GMenuBar *bar)
{
    GEditorItem *editem;                    /* Autre version de la barre   */
    GtkViewPanel *panel;                    /* Vue offrant l'affichage     */
    const vmpa2t *curloc;                   /* Localisation d'un curseur   */
    GLoadedBinary *binary;                  /* Binaire en cours d'étude    */
    GDbCollection *collec;                  /* Collection à manipuler      */
    GDbItem *exist;                         /* Sens du basculement courant */
    GObject *ref;                           /* Espace de référencements    */
    GtkWidget *dialog;                      /* Boîte de dialogue à montrer */
    GDbItem *bookmark;                      /* Nouveau signet défini       */
    gint ret;                               /* Retour de confirmation      */

    editem = G_EDITOR_ITEM(bar);

    /* Détermination de l'adresse visée */

    panel = g_editor_item_get_current_view(editem);

    if (!GTK_IS_BUFFER_VIEW(panel))
        curloc = NULL;
    else
        curloc = gtk_buffer_view_get_caret_location(GTK_BUFFER_VIEW(panel));

    /* Accès à la collection */

    binary = g_editor_item_get_current_binary(editem);
    collec = g_loaded_binary_find_collection(binary, DBF_BOOKMARKS);

    /**
     * On choisit de se passer de verrou ici :
     *  - si l'élément existe, la suppression prend en compte le fait
     *    que l'élément puisse disparaître entre temps.
     *  - si l'élément n'existe pas, une boîte de dialogue est prévue
     *    au moment de l'insertion finale. Dans ce cas, l'utilisateur
     *    peut de plus modifier la position pendant la définition.
     */

    if (curloc == NULL)
        exist = NULL;
    else
        exist = NULL;//g_db_collection_has_key(collec, curloc);

    if (exist != NULL)
        g_loaded_binary_remove_from_collection(binary, DBF_BOOKMARKS, exist);

    else
    {
        ref = g_editor_item_get_global_ref(G_EDITOR_ITEM(bar));
        dialog = create_bookmark_dialog(GTK_WINDOW(ref), curloc);

        if (gtk_dialog_run(GTK_DIALOG(dialog)) == GTK_RESPONSE_OK)
        {
            bookmark = get_item_from_bookmark_dialog(dialog);

            g_db_collection_wlock(G_DB_COLLECTION(collec));

            if (g_db_collection_has_item(collec, G_DB_ITEM(bookmark)))
            {
                ret = qck_show_question(GTK_WINDOW(ref),
                                        _("Location  already bookmarked!"),
                                        _("A bookmark has been defined at the same location.\n" \
                                          "Do you want to replace it ?"));

                if (ret != GTK_RESPONSE_YES)
                    goto mcb_ebt_add_finish;

            }

            _g_loaded_binary_add_to_collection(binary, DBF_BOOKMARKS, G_DB_ITEM(bookmark), false);

        mcb_ebt_add_finish:

            g_db_collection_wunlock(G_DB_COLLECTION(collec));

        }

        gtk_widget_destroy(dialog);

    }

    g_object_unref(G_OBJECT(collec));

}


/******************************************************************************
*                                                                             *
*  Paramètres  : menuitem = élément de menu sélectionné.                      *
*                bar      = barre de menu parente.                            *
*                                                                             *
*  Description : Réagit avec le menu "Edition -> Signets -> Effacer tous...". *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void mcb_edition_bookmarks_delete_all(GtkMenuItem *menuitem, GMenuBar *bar)
{

}


/******************************************************************************
*                                                                             *
*  Paramètres  : menuitem = élément de menu sélectionné.                      *
*                bar      = barre de menu parente.                            *
*                                                                             *
*  Description : Réagit avec le menu "Edition -> Commentaires -> Inscrire...".*
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void mcb_edition_comment_enter(GtkMenuItem *menuitem, GMenuBar *bar)
{

}


/******************************************************************************
*                                                                             *
*  Paramètres  : menuitem = élément de menu sélectionné.                      *
*                bar      = barre de menu parente.                            *
*                                                                             *
*  Description : Réagit avec le menu "Edition -> Commentaires -> Ins. rep...".*
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void mcb_edition_comment_enter_repeatable(GtkMenuItem *menuitem, GMenuBar *bar)
{

}


/******************************************************************************
*                                                                             *
*  Paramètres  : menuitem = élément de menu sélectionné.                      *
*                bar      = barre de menu parente.                            *
*                                                                             *
*  Description : Réagit avec le menu "Edition -> Commentaires -> Ins. av...". *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void mcb_edition_comment_enter_previous(GtkMenuItem *menuitem, GMenuBar *bar)
{

}


/******************************************************************************
*                                                                             *
*  Paramètres  : menuitem = élément de menu sélectionné.                      *
*                bar      = barre de menu parente.                            *
*                                                                             *
*  Description : Réagit avec le menu "Edition -> Commentaires -> Ins. ap...". *
*                                                                             *
*  Retour      : -                                                            *
*                                                                             *
*  Remarques   : -                                                            *
*                                                                             *
******************************************************************************/

static void mcb_edition_comment_enter_next(GtkMenuItem *menuitem, GMenuBar *bar)
{

}