Comparer deux textes

Ce qui compte comme une même ligne

La comparaison porte sur une clé plutôt que sur la ligne elle-même. Chaque ligne est réduite à une clé selon les options « Ignorer » activées, le diff s'exécute sur les clés, et ce qui vous est affiché est toujours votre texte d'origine — activer « Ignorer les majuscules » change donc les lignes qui concordent sans modifier un seul caractère de ce qui est affiché. Il existe deux options d'espacement distinctes, et elles diffèrent plus que leurs libellés ne le laissent penser : l'une supprime les espaces aux extrémités d'une ligne, l'autre réduit d'abord les suites d'espaces et de tabulations à un seul espace, puis supprime les extrémités. Aucune ne retire complètement les espaces, et la réduction ne vise que les espaces et tabulations littéraux : un espace idéographique ou un espace insécable au milieu d'une ligne reste tel quel et compte toujours comme une différence.

Ignorer les lignes vides est l'option dont personne ne mentionne la conséquence : les lignes vides sont retirées avant la comparaison, si bien que les numéros de ligne affichés à côté du résultat ne comptent que les lignes restantes, et ne correspondent plus à ceux de votre fichier. Option désactivée, ils correspondent exactement. Le surlignage des mots à l'intérieur d'une ligne modifiée suit le réglage « Ignorer les majuscules » et rien d'autre — les options d'espacement ne s'y appliquent pas : des différences d'espacement dans une ligne modifiée pour une autre raison sont donc tout de même signalées comme des modifications.

Le résultat copiable est un diff unifié à tous les égards qui comptent pour le lire — les deux en-têtes de fichier, les lignes en moins, les lignes en plus, trois lignes de contexte autour de chaque modification —, à une exception près, à connaître avant de vous y fier. Ses marqueurs de bloc ne portent aucune plage de lignes : il est fait pour un rapport de bug, un commentaire de revue de code ou un e-mail, et les commandes patch et git apply le refuseront. Si vous avez besoin de quelque chose à appliquer plutôt qu'à lire, produisez-le avec git.

Si vous cherchez autre chose

Les formats structurés se comparent mal ligne par ligne, et l'échec est flagrant plutôt que subtil : deux documents JSON qui ne diffèrent que par l'ordre de leurs clés, ou deux CSV dont une colonne a été déplacée, reviennent sous la forme d'un mur de modifications qui ne vous apprend rien. Comparez-les avec un outil qui comprend leur forme — triez d'abord les clés des deux fichiers JSON et comparez les résultats, ou utilisez daff, qui compare les CSV en lignes et en colonnes et vous dira qu'une colonne a été déplacée plutôt que d'annoncer que chaque ligne a changé.

Deux dossiers, ou deux moments de l'historique d'un dépôt, relèvent de git plutôt que de cette page. Et pour de la prose dont les paragraphes ont été remis en forme, une vue par lignes n'est tout simplement pas la bonne granularité — git diff --word-diff ignore l'emplacement des retours à la ligne et ne vous montre que les mots qui ont bougé, ce qui est la comparaison que vous vouliez vraiment quand un document a été remis en page.