# Manuel d'utilisation de Meld

## Introduction

### Qu'est-ce que meld ?

Meld permet d'afficher les différences entre des fichiers ou des répertoires. Meld facilite la localisation et la fusion de ces différences.

### Démarrage de meld

#### Paramètres de la ligne de commande

`meld`

- démarre meld avec la boîte de dialogue « nouveau document »

`meld <fichier> <fichier> [fichier]`

- démarre meld pour une comparaison entre deux ou trois fichiers

`meld <rép> <rép> [rép]`

- démarre meld pour une comparaison entre deux ou trois fichiers

`meld <rép|fichier>`

- démarre meld avec le navigateur du gestionnaire de source

« <> » entoure les paramètres obligatoires, « [] » entoure les paramètres optionnels et « | » indique un choix.

Saisissez `meld --help` pour obtenir la liste complète des options

## Comparaison de fichiers

### Démarrage

Pour comparer des fichiers, choisissez Fichier Nouveau et sélectionnez l'onglet Comparaison de fichiers. Vous pouvez comparer deux ou trois fichiers.

Pour une comparaison à deux éléments, l'original est affiché par convention dans le panneau de gauche et la version modifiée dans celui de droite.

Pour une comparaison à trois éléments, l'original est affiché dans le panneau du centre et les panneaux gauche et droite affichent les versions modifiées. Par convention, le fichier modifié local est dans le panneau de droite.

### Résumé des changements

L'emplacement des changements est résumé dans les marges de la fenêtre à l'extrême gauche et droite. Par défaut, les insertions et les suppressions sont signalées en vert et les modifications en bleu.

Vous pouvez vous déplacer à un changement particulier en cliquant dans la marge ou en utilisant l'ascenseur.

### Affichage détaillé

Le détail des différences est affiché dans le texte et dans le panneau central. Le texte inséré est affiché avec un arrière-plan de couleur. Les lignes modifiées sont marquées d'une couleur d'arrière-plan claire avec les modifications mis en évidence à l'aide d'une couleur plus foncée.

La zone entre chaque fichier affiche l'emplacement des modifications dans l'autre fichier. Vous pouvez faire défiler les modifications en utilisant la molette de la souris sur cette zone ou en utilisant les raccourcis clavier Ctrl D, Ctrl E.

### Édition

Vous pouvez modifier les fichiers comme vous le feriez à l'aide d'un éditeur de texte normal. Les différences se mettent à jour automatiquement. Utilisez Ctrl F pour faire des recherches et Ctrl G pour répéter la dernière recherche.

Vous pouvez également appliquer les modifications en cliquant sur les boutons de fusion (« -> » et « <- »). En appuyant sur la touche Maj, vous pouvez supprimer des blocs entiers. En appuyant sur la touche Ctrl, vous pouvez insérer la modification actuelle avant ou après l'autre modification.

Vous pouvez appliquer toutes les modifications à partir d'un des fichiers en cliquant avec le bouton droit sur un volet de texte et en choisissant Tout copier à gauche ou Tout copier à droite. Vous pouvez également lancer un éditeur externe à partir de ce menu. Configurez l'éditeur externe grâce au menu Paramètres Préférences.

### Filtre

Vous pouvez ignorer certaines sortes de différences afin de localiser les différences importantes. Tous ces réglages sont disponibles dans la section Filtres de texte de la boîte de dialogue Préférences.

#### Expressions régulières

Quand vous comparez des fichiers, chaque expression régulière sélectionnée est lancée successivement sur chaque ligne d'entrée. Tout ce qui correspond à l'expression régulière est effacé de l'entrée.

Voir le module Python des expressions régulières (« re ») pour plus d'informations sur les expressions régulières

Les différences sont évaluées ligne par ligne. Les expressions régulières sur plusieurs lignes auront donc certainement des conséquences inattendues.

#### Lignes vides

Les modifications qui insèrent ou suppriment des lignes vides peuvent être ignorées. Cette option est très utile conjointement avec un ou plusieurs filtres avec expressions régulières.

### Enregistrement

Quand des modifications ne sont pas enregistrées, une icône de disque apparaît à côté du nom du fichier modifié. L'étiquette de l'onglet et le titre de la fenêtre ont également un astérisque à la suite du nom du fichier.

Pour enregistrer un fichier, choisissez Fichier Enregistrer, tapez Ctrl S ou cliquez sur le bouton Enregistrer de la barre d'outils. Toutes ces actions enregistrent le fichier qui est actuellement actif (le fichier qui contient le curseur).

### Barre d'état

La barre d'état affiche la position du curseur (ligne et colonne) ainsi que des messages de progression lorsque les fichiers sont initialement chargés et comparés.

## Comparaison de dossiers

### Démarrage

Pour comparer des répertoires, choisissez Fichier Nouveau puis l'onglet Comparaison de répertoires. Vous pouvez comparer deux ou trois répertoires.

Pour une comparaison à deux éléments, l'original est affiché par convention dans le panneau de gauche et la version modifiée dans celui de droite.

Pour une comparaison à trois éléments, l'original est affiché dans le panneau du centre et les panneaux gauche et droite affichent les versions modifiées. Par convention, le fichier modifié local est dans le panneau de droite.

### Résumé des changements

De la même manière que pour les comparaisons de fichiers, les marges des fenêtres indiquent les destructions, créations et modifications de fichiers.

Vous pouvez vous déplacer à un changement particulier en cliquant dans la marge ou en utilisant l'ascenseur.

### Affichage détaillé

Les fichiers modifiés sont mis en évidence en rouge, ceux créés en vert et ceux détruits sont barrés. Voir également dir_content_filtering.

Le fichier ou le dossier dont la modification est la plus récente est marqué d'un point rouge sur son icône. Des informations plus détaillées telles que les permissions de fichiers et la date de modification sont affichées dans la barre d'état quand un fichier est sélectionné.

Utilisez la souris ou les touches fléchées Haut, Bas, Gauche et Droite pour vous déplacer. De plus, Ctrl D et Ctrl E effectuent un déplacement vers la prochaine ou la précédente modification respectivement.

### Édition

Activez un élément en double-cliquant ou tapez Entrée pour démarrer une comparaison de fichiers individuelle.

Des options supplémentaires sont disponibles via le menu contextuel du bouton droit.

Utilisez Maj+Clic et Ctrl+Clic pour sélectionner plusieurs éléments.

### Filtre

La première comparaison contient souvent trop d'informations erronées. Vous pouvez utiliser les filtres pour isoler les différences qui sont importantes pour vous.

#### Masquage explicite

Utilisez le bouton de la barre d'outils pour cacher un élément (et tous les sous-éléments pour les répertoires).

#### Sensibilité à la casse

Par défaut, les comparaisons de noms de fichiers sont sensibles à la casse. Utilisez le bouton de la barre d'outils pour modifier la sensibilité à la casse des noms de fichiers.

#### Filtre sur l'état

Tous les éléments ont un état qui est l'un des suivants :

- Modifié (il y a des différences de contenu entre les fichiers présents)

- Nouveau (il n'y a pas de différence de contenu entre les fichiers présents mais le fichier manque dans au moins un répertoire)

- Identique (tous les fichiers ont des contenus identiques et sont tous présents)

Utilisez les boutons de la barre d'outils pour contrôler quels éléments sont affichés en fonction de leur état.

Dans la version actuelle, seuls les fichiers sont filtrés par état. Les répertoires sont toujours affichés.

#### Filtre sur les noms

Meld permet de cacher certains modèles de nom de fichier de la comparaison en utilisant les boutons de la barre d'outils. Personnalisez vos modèles de fichiers cachés dans la section Filtrage de fichiers de la boîte de dialogue Préférences.

#### Filtre sur le contenu

Si des différences entre fichiers existent mais que toutes ces différences correspondent à l'expression régulière actuelle indiquée dans la section Filtre de texte de la boîte de dialogue Préférences, alors le nom du fichier n'est pas mis en évidence en rouge mais est plutôt mis en italique de la police standard.

## Contrôle de source

### Démarrage

Pour faire des recherches dans une copie de travail d'un dépôt de gestion de version, choisissez Fichier Nouveau puis l'onglet Navigateur du gestionnaire de versions.

Le navigateur est utilisé pour examiner et valider ou rétablir des modifications locales. Son but n'est pas d'être un outil de gestion de versions complet.

### Filtre

Le navigateur peut filtrer sur quatre états. Pour montrer ou cacher tous les fichiers dans un état particulier, sélectionnez ou désélectionnez le bouton correspondant dans la barre d'outils.

Normal

- Le fichier n'a pas été modifié depuis qu'il a été extrait ou commité.

Modifié

- Le fichier a été modifié localement, ajouté ou supprimé.

Non contrôlé par version

- Le fichier n'est pas contrôlé par version : il existe localement mais n'a pas été extrait d'un dépôt.

Ignoré

- Le fichier est explicitement ignoré, par exemple au travers d'un fichier `.cvsignore`.

Le bouton Aplatir affiche la liste des répertoires comme une liste simple, montrant en même temps tous les contenus des sous-répertoires. Ceci rend plus aisée la vision de nombreux changements éparpillés dans de nombreux répertoires ou dans une grande arborescence. Ceci est plus spécialement utile si le filtre modifié est activé simultanément.

### Affichage des différences

L'activation d'un fichier non modifié ouvre celui-ci dans le visionneur. L'activation d'un fichier modifié affiche une comparaison des deux fichiers afin d'examiner leurs différences.

Vous pouvez examiner plusieurs modifications à la fois en utilisant Maj+Clic et Ctrl+Clic pour sélectionner plusieurs éléments.

### Modifications

La barre d'outils contient les commandes pour réaliser les opérations de gestion de versions les plus courantes. Ces opérations sont également accessibles grâce au menu contextuel.

### Affichage de la console

En bas de la fenêtre de contrôle de source, une icône d'extension contient toutes les opérations de gestion de versions et leur sortie. Cliquez sur la barre de l'icône d'extension pour cacher ou montrer la console.