Ligne de commande


La ligne de commande de WinMerge accepte plusieurs paramètres en plus des chemins à comparer. La plupart de ces paramètres sont destinés à utiliser WinMerge en tant qu'application de comparaison externe ou à démarrer une opération de comparaison à partir d'un fichier séquentiel (batch).

Utilisez l'un de ces formats pour la commande WinMerge :

WinMergeU [/?]

WinMergeU [/r] [/r-] [/e] [/f filtre] [/m méthode-comparaison] [/t type-fenêtre] [/x] [/xq] [/s] [/sw] [/s-] [/ul] [/um] [/ur] [/u] [/wl] [/wm] [/wr] [/new] [/self-compare] [/clipboard-compare] [/minimize] [/maximize] [/fl] [/fm] [/fr] [/l numéroligne] [/c poscaractère] [/table-delimiter délimiteur] [/dl desc_gauche] [/dm desc_milieu] [/dr desc_droite] [/al] [/am] [/ar] [/noninteractive] [/noprefs] [/enableexitcode] [/ignorews] [/ignoreblanklines] [/ignorecase] [/ignoreeol] [/ignorecodepage] [/ignorecomments] [/unpacker nom-décompresseur] [/prediffer nom-prediffer] [/cp page-de-code] [/fileext extension-fichier] [/cfg nom=valeur] [/inifile fichier_ini] chemin_gauche [chemin_milieu] chemin_droite [/o chemin_sortie] [/or chemin_rapport]

WinMergeU fichier_conflit

L'entrée de la commande sans paramètres ni noms de chemin ouvre simplement la fenêtre WinMerge. Les paramètres sont préfixés soit par une barre oblique ( / ), soit par un tiret ( - ). Les noms de chemin n'ont pas de caractère de préfixe.

/?

Ouvre l'aide de WinMerge sur cette rubrique.

/r

Compare tous les fichiers dans tous les sous-dossiers (comparaison récursive). Les dossiers uniques (présents d'un seul côté) sont répertoriés dans le résultat de la comparaison comme des éléments distincts. Notez que l'inclusion des sous-dossiers peut augmenter considérablement le temps de comparaison. Sans ce paramètre, WinMerge répertorie uniquement les fichiers et les sous-dossiers au niveau supérieur des deux dossiers cibles. Il ne compare pas les sous-dossiers.

/r-

Compare tous les fichiers dans les dossiers spécifiés, mais exclut les fichiers et sous-dossiers situés dans ses sous-dossiers. Cela permet un temps de comparaison plus court.

/e

Permet de fermer WinMerge d'une seule pression sur la touche Echap. C'est utile lorsque vous utilisez WinMerge comme application de comparaison externe : vous pouvez fermer WinMerge rapidement, comme une boîte de dialogue. Sans ce paramètre, vous devrez peut-être appuyer sur Echap plusieurs fois pour fermer toutes ses fenêtres.

/f

Applique un filtre spécifié pour restreindre la comparaison. Le filtre peut être un masque de fichier comme *.h *.cpp, ou le nom d'un filtre de fichier comme XML/HTML Devel. Ajoutez des guillemets autour d'un masque de filtre ou d'un nom contenant des espaces.

/m méthode-comparaison

Définit la méthode de comparaison à utiliser pour la comparaison. Cela peut être l'un des mots-clés Full (Complet), Quick (Rapide), Binary (Binaire), Date, SizeDate, Size (Taille) ou Existence.

/t type-fenêtre

Spécifie le type de fenêtre dans laquelle afficher les fichiers. Cela peut être l'un des mots-clés Text (Texte), Table (Tableau), Binary (Binaire), Image ou Webpage (Page Web).

/x

Ferme WinMerge (après l'affichage d'une boîte de dialogue d'information) lorsque vous lancez une comparaison de fichiers identiques. Le paramètre n'a aucun effet après la comparaison, par exemple si les fichiers deviennent identiques suite à une fusion ou à une édition. Ce paramètre est utile lorsque vous utilisez WinMerge comme application de comparaison externe, ou lorsque vous souhaitez éliminer les étapes inutiles en ignorant les fichiers qui n'ont aucune différence.

/xq

Est similaire à /x mais n'affiche pas le message concernant les fichiers identiques.

/s

Limite les fenêtres WinMerge à une seule instance. Par exemple, si WinMerge est déjà en cours d'exécution, une nouvelle comparaison s'ouvre dans la même instance. Sans ce paramètre, plusieurs fenêtres sont autorisées : selon d'autres paramètres, une nouvelle comparaison peut s'ouvrir dans la fenêtre existante ou dans une nouvelle fenêtre.

/sw

Limite la fenêtre WinMerge à une seule instance, tout comme l'option /s. Cependant, elle attend que l'instance affichant la fenêtre se termine.

/s-

Garantit qu'une autre instance est toujours exécutée, en ignorant la valeur de l'option « N'autoriser qu'une seule instance à s'exécuter ».

/ul

Empêche WinMerge d'ajouter le chemin de gauche à la liste des éléments les plus récemment utilisés (MRU). Les applications externes ne devraient pas ajouter de chemins à la liste MRU dans la boîte de dialogue Sélectionner des fichiers ou des dossiers.

/um

Empêche WinMerge d'ajouter le chemin du milieu à la liste des éléments les plus récemment utilisés (MRU). Les applications externes ne devraient pas ajouter de chemins à la liste MRU dans la boîte de dialogue Sélectionner des fichiers ou des dossiers.

/ur

Empêche WinMerge d'ajouter le chemin de droite à la liste des éléments les plus récemment utilisés (MRU). Les applications externes ne devraient pas ajouter de chemins à la liste MRU dans la boîte de dialogue Sélectionner des fichiers ou des dossiers.

/u

Empêche WinMerge d'ajouter l'un ou l'autre chemin (gauche ou droite) à la liste des éléments les plus récemment utilisés (MRU). Les applications externes ne devraient pas ajouter de chemins à la liste MRU dans la boîte de dialogue Sélectionner des fichiers ou des dossiers.

/wl

Ouvre le côté gauche en lecture seule. Utilisez cette option lorsque vous ne souhaitez pas modifier les éléments du côté gauche lors de la comparaison.

/wm

Ouvre le côté du milieu en lecture seule. Utilisez cette option lorsque vous ne souhaitez pas modifier les éléments du côté droit lors de la comparaison.

/wr

Ouvre le côté droit en lecture seule. Utilisez cette option lorsque vous ne souhaitez pas modifier les éléments du côté droit lors de la comparaison.

/new

Ouvre une nouvelle fenêtre vide.

/self-compare

Compare le fichier spécifié avec une copie de lui-même.

/clipboard-compare

Compare les deux contenus les plus récents de l'historique du presse-papiers.

/minimize

Démarre WinMerge en tant que fenêtre réduite. Cette option peut être utile lors de comparaisons de longue durée.

/maximize

Démarre WinMerge en tant que fenêtre agrandie.

/fl

Place le focus sur le côté gauche au démarrage.

/fm

Place le focus sur le côté du milieu au démarrage.

/fr

Place le focus sur le côté droit au démarrage.

/l numéroligne

Spécifie un numéro de ligne vers lequel sauter après le chargement des fichiers.

/c poscaractère

Spécifie une position de caractère vers laquelle sauter après le chargement des fichiers.

/table-delimiter délimiteur

Spécifie un caractère délimiteur pour l'édition de tableaux. Pour spécifier une tabulation, indiquez « tab », « \t » ou « \x09 ».

/dl

Spécifie une description dans la barre de titre du côté gauche, remplaçant le texte par défaut du dossier ou du nom de fichier. Par exemple : /dl "Version 1.0" ou /dl WorkingCopy. Utilisez des guillemets autour des descriptions contenant des espaces.

/dm

Spécifie une description dans la barre de titre du côté milieu, tout comme /dl.

/dr

Spécifie une description dans la barre de titre du côté droit, tout comme /dl.

/al

Fusionne automatiquement sur le côté gauche au démarrage.

/am

Fusionne automatiquement sur le côté milieu au démarrage.

/ar

Fusionne automatiquement sur le côté droit au démarrage.

/noninteractive

Exécute WinMerge sans afficher de boîtes de message pendant la comparaison ou la génération de rapports. Le processus se termine automatiquement lorsque l'opération est terminée, ce qui le rend adapté à l'exécution par batch ou par script.

/noprefs

Exécute WinMerge sans charger ni enregistrer les paramètres du registre. Toutes les comparaisons utilisent uniquement les préférences par défaut.

/enableexitcode

Définit le résultat de la comparaison comme code de sortie du processus. 0 : identique, 1 : différent, 2 : erreur

/ignorews

Contrôle l'option « Espaces » (paramètres de comparaison des espaces blancs) de manière persistante :

  • /ignorews:0 - n'ignore pas les différences d'espaces blancs.

  • /ignorews ou /ignorews:1 - ignore les différences de quantité d'espaces blancs.

  • /ignorews:2 - ignore tous les caractères d'espacement.

/ignoreblanklines

Contrôle l'option « Ignorer les lignes vides » de manière persistante :

  • /ignoreblanklines:0 - désactive l'ignorance des lignes vides.

  • /ignoreblanklines ou /ignoreblanklines:1 - active l'ignorance des lignes vides.

/ignorecase

Contrôle l'option « Ignorer la casse » de manière persistante :

  • /ignorecase:0 - désactive l'ignorance des différences de casse.

  • /ignorecase ou /ignorecase:1 - active l'ignorance des différences de casse.

/ignoreeol

Contrôle l'option « Ignorer les différences EOL » de manière persistante :

  • /ignoreeol:0 - désactive l'ignorance des différences EOL (fin de ligne).

  • /ignoreeol ou /ignoreeol:1 - active l'ignorance des différences EOL (fin de ligne).

/ignorecodepage

Contrôle l'option « Ignorer les différences de page de code » de manière persistante :

  • /ignorecodepage:0 - désactive l'ignorance des différences de page de code.

  • /ignorecodepage ou /ignorecodepage:1 - active l'ignorance des différences de page de code.

/ignorecomments

Contrôle l'option « Ignorer les différences de commentaires » de manière persistante :

  • /ignorecomments:0 - désactive l'ignorance des commentaires.

  • /ignorecomments ou /ignorecomments:1 - active l'ignorance des commentaires.

/unpacker pipeline de plug-ins

Spécifie le pipeline de plug-ins pour le plug-in Unpacker. Exemple : /unpacker "SortAscending|SelectLines 1-10"

/prediffer pipeline de plug-ins

Spécifie le pipeline de plug-ins pour le plug-in Prediffer. Exemple : /prediffer "IgnoreColumns 1-10"

/cp page-de-code

Spécifie la page de code à utiliser pour la comparaison de fichiers. Exemple : /cp 65001

/fileext extension-fichier

Spécifie une extension de fichier pour déterminer la coloration syntaxique.

/cfg nom=valeur

Définit une valeur de configuration dans le registre WinMerge ou dans le fichier INI.

Exemple : /cfg Settings/DiffAlgorithm=3

Si le nom de la section est sans ambiguïté et n'entre pas en conflit avec d'autres noms de paramètres, il peut être omis :

/cfg DiffAlgo=3

Remarque : Cette entrée n'explique pas quels noms de configuration sont disponibles. Pour une liste des paramètres, reportez-vous à HKEY_CURRENT_USER\Software\Thingamahoochie\WinMerge dans regedit.

chemin_gauche

Spécifie le dossier, le fichier ou le fichier de projet à ouvrir sur le côté gauche.

chemin_milieu

Spécifie le dossier, le fichier ou le fichier de projet à ouvrir sur le côté milieu.

chemin_droite

Spécifie le dossier, le fichier ou le fichier de projet à ouvrir sur le côté droit.

WinMerge ne peut pas comparer des fichiers à des dossiers. Les paramètres de chemin (chemin_gauche, chemin_milieu et chemin_droite) doivent donc pointer vers le même type de cible (soit des dossiers, soit des fichiers). Si WinMerge ne trouve pas l'un des chemins spécifiés, il ouvre la boîte de dialogue Sélectionner des fichiers ou des dossiers, où vous pouvez rechercher les chemins corrects.

Tip

Dans les comparaisons de fichiers, vous pouvez spécifier un nom de dossier dans l'un des paramètres de chemin, à condition que le dossier contienne un fichier portant le même nom que celui spécifié dans l'autre chemin de fichier.

Par exemple, considérez cette commande :

WinMergeU C:\Dossier\Fichier.txt C:\Dossier2

Si C:\Dossier2 contient un fichier nommé Fichier.txt : WinMerge résout implicitement le deuxième chemin comme une spécification de fichier et compare les deux fichiers. Bien entendu, la commande n'est pas valide si C:\Dossier2 ne contient pas de fichier nommé Fichier.txt.

/o chemin_sortie

Spécifie un chemin de fichier de sortie facultatif où vous souhaitez que les fichiers de résultats fusionnés soient enregistrés.

Le chemin de sortie est rarement nécessaire lorsque vous lancez WinMerge à partir de la ligne de commande. Il est destiné à être utilisé avec des outils de contrôle de version, où vous pourriez avoir besoin de spécifier un chemin de sortie pour le fichier résultat. Si vous spécifiez un chemin de sortie, WinMerge n'affiche toujours que deux ou trois fichiers dans la fenêtre de comparaison de fichiers. Cependant, si vous enregistrez l'un de ces fichiers, il est écrit sur le chemin de sortie, laissant les deux ou trois fichiers sources intacts.

Les systèmes de contrôle de version font généralement référence aux fichiers sources et résultats à l'aide de termes tels que theirs (le leur), mine (le mien), et soit merged (fusionné) soit resolved (résolu). Si vous spécifiez un chemin de sortie sur la ligne de commande WinMerge et que vous travaillez avec un système de contrôle de version, vous devez lister les fichiers dans cet ordre.

/or cheminsortie

Génère un rapport de comparaison pour les fichiers ou les dossiers. Exemple : WinMergeU chemin1 chemin2 /or c:\tmp\rapport.html

Il est souvent utile de combiner cette option avec :

  • /noninteractive - quitte WinMerge après avoir produit le rapport.

  • /minimize - démarre WinMerge à l'état réduit.

  • /noprefs - ignore les préférences actuelles et utilise les paramètres par défaut. Toutes les modifications effectuées avec /cfg seront alors temporaires et ne seront pas enregistrées.

Les paramètres /cfg suivants peuvent également être utiles (les noms des paramètres peuvent changer à l'avenir) :

Pour les comparaisons de fichiers :

  • /cfg Settings/DiffContextV2=0 - masque les lignes correspondantes dans le rapport (équivalent à Vue -> Contexte Diff -> 0 lignes).

  • /cfg Settings/ViewLineNumbers=1 - affiche les numéros de ligne (définir sur 0 pour désactiver).

Pour les comparaisons de dossiers :

  • /cfg Settings/DirViewExpandSubdirs=1 - développe automatiquement tous les sous-dossiers.

  • /cfg ReportFiles/ReportType=2 - style de rapport : HTML Simple.

  • /cfg ReportFiles/IncludeFileCmpReport=1 - inclut les rapports de comparaison de fichiers.

fichier_conflit

Spécifie un fichier de conflit, généralement généré par un système de contrôle de version. Le fichier de conflit s'ouvre dans la fenêtre de comparaison de fichiers, où vous pouvez fusionner et résoudre les conflits, comme décrit dans Résolution de fichiers de conflit. Notez qu'aucun autre chemin ne peut être utilisé avec un fichier de conflit.

/inifile fichier_ini

spécifie un fichier INI utilisé pour charger et enregistrer les paramètres au lieu du registre.