Comparer des commits et des branches
Le panneau Comparer montre en quoi deux commits ou deux branches diffèrent : les commits qui ne se trouvent que d’un côté, et la modification d’ensemble entre les deux. Il s’ouvre à droite de l’onglet du dépôt, à la place du détail du commit.
Comparer deux commits
Section intitulée « Comparer deux commits »- Dans le graphe des commits, cliquez sur un commit, puis faites ⌘-clic (Ctrl-clic sous Windows et Linux) sur un second.
- Au choix :
- Cliquez sur Comparer dans la barre de sélection qui apparaît en bas du graphe.
- Faites un clic droit sur l’un des deux commits, puis choisissez Comparer ces 2 commits.
- Lancez Comparer les 2 commits sélectionnés depuis la palette de commandes (⌘K, Ctrl+K sous Windows et Linux).
Ces entrées ne sont disponibles que lorsque exactement deux commits sont sélectionnés. Le côté A est le commit le plus récent, le côté B le plus ancien, tous deux désignés par leur SHA court.
Pour comparer un commit avec HEAD, faites un clic droit dessus, puis choisissez Comparer avec HEAD. Le côté A est le commit, le côté B est HEAD.
Comparer deux branches
Section intitulée « Comparer deux branches »| Point d’entrée | Ce qui est comparé |
|---|---|
| Barre latérale : clic droit sur une branche, puis Comparer avec branche courante | Cette branche (A) avec la branche courante (B) |
| Barre latérale : clic droit sur une branche, puis Comparer avec… | Ouvre la boîte de dialogue ci-dessous, avec cette branche comme Branche |
| Palette de commandes : Comparer deux branches… | Ouvre la boîte de dialogue ci-dessous |
Comparer avec branche courante est désactivé sur la branche courante et quand HEAD est détaché : « Extrais une autre branche pour comparer ».
La boîte de dialogue Comparer deux branches liste les branches locales et distantes :
- Choisissez une Branche (côté A).
- Choisissez dans Comparée à la branche à laquelle la comparer (côté B). Par défaut, c’est la branche courante.
- Cliquez sur Comparer. Le bouton reste désactivé tant que les deux branches sont identiques : « Choisis deux branches différentes. »
Lire le panneau Comparer
Section intitulée « Lire le panneau Comparer »L’en-tête du panneau affiche les deux côtés, A ⇄ B. Inverser les côtés les échange. En dessous, Merge-base : donne le SHA court de l’ancêtre commun des deux côtés (git merge-base) ; cliquez dessus pour sélectionner ce commit dans le graphe. Si les deux côtés n’ont aucun historique en commun, le panneau indique « Aucun ancêtre commun : historiques sans lien ».
Passez d’une vue à l’autre avec Commits et Modifications.
Deux listes, Seulement dans A et Seulement dans B, chacune avec un compteur. Elles contiennent les commits accessibles depuis un côté mais pas depuis l’autre, comme git log B..A et git log A..B. Un côté sans commit affiche Aucun commit.
Chaque liste montre jusqu’à 1000 commits ; au-delà, « N commits de plus, non listés (1000 premiers affichés) ». Cliquez sur un commit pour le sélectionner dans le graphe.
Modifications
Section intitulée « Modifications »La liste de fichiers « Modifications B → A » (les deux côtés sous forme de SHA courts) contient la différence d’ensemble entre les deux côtés, telle que l’afficherait git diff B A : ce que A a et que B n’a pas. Chaque fichier affiche son statut et ses nombres de lignes +/−. Cliquez sur un fichier pour ouvrir son diff au centre, avec toutes les fonctions du visualiseur de diff. Si les deux côtés ont le même contenu, la liste indique « Aucune différence entre les deux ».
Pour deux commits, B est le plus ancien : les modifications se lisent donc du plus ancien au plus récent.
Mises à jour et erreurs
Section intitulée « Mises à jour et erreurs »Le panneau se recalcule quand des branches ou des tags changent. En cas d’échec, il affiche « La comparaison n’a pas pu être chargée » avec Réessayer. La comparaison n’exécute aucune commande Git : yaggui lit directement l’historique.
Fermez le panneau avec Fermer la comparaison. La comparaison n’est pas conservée quand vous fermez le dépôt.
Aller au merge-base
Section intitulée « Aller au merge-base »Pour sélectionner dans le graphe l’ancêtre commun de deux commits :
- Avec deux commits sélectionnés : Merge-base dans la barre de sélection, Aller à leur merge-base dans le menu contextuel, ou l’action de la palette Aller au merge-base des 2 commits sélectionnés.
- Pour un commit et HEAD : faites un clic droit sur le commit, puis choisissez Aller au merge-base avec HEAD.
- Pour deux branches : comparez-les, puis cliquez sur le SHA qui suit Merge-base : dans le panneau.
Le merge-base est sélectionné et centré. Si les historiques n’ont aucun lien, une notification indique « Aucun ancêtre commun : ces historiques n’ont pas de lien ». Si un filtre du graphe masque le merge-base, il reste sélectionné et son détail s’affiche, avec « Le merge-base abc1234 n’est pas affiché dans le graphe (filtre) ».