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.
/rCompare 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.
/ePermet 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.
/fApplique un filtre spécifié pour restreindre la comparaison. Le filtre peut
être un masque de fichier comme , ou le nom d'un filtre de fichier comme
*.h
*.cppXML/HTML Devel. Ajoutez des guillemets autour d'un
masque de filtre ou d'un nom contenant des espaces.
/m méthode-comparaisonDé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êtreSpé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).
/xFerme 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.
/xqEst similaire à /x mais n'affiche pas le message concernant
les fichiers identiques.
/sLimite 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.
/swLimite 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 ».
/ulEmpê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.
/umEmpê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.
/urEmpê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.
/uEmpê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.
/wlOuvre 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.
/wmOuvre 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.
/wrOuvre 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.
/newOuvre une nouvelle fenêtre vide.
/self-compareCompare le fichier spécifié avec une copie de lui-même.
/clipboard-compareCompare les deux contenus les plus récents de l'historique du presse-papiers.
/minimizeDémarre WinMerge en tant que fenêtre réduite. Cette option peut être utile lors de comparaisons de longue durée.
/maximizeDémarre WinMerge en tant que fenêtre agrandie.
/flPlace le focus sur le côté gauche au démarrage.
/fmPlace le focus sur le côté du milieu au démarrage.
/frPlace le focus sur le côté droit au démarrage.
/l numéroligneSpécifie un numéro de ligne vers lequel sauter après le chargement des fichiers.
/c poscaractèreSpécifie une position de caractère vers laquelle sauter après le chargement des fichiers.
/table-delimiter délimiteurSpécifie un caractère délimiteur pour l'édition de tableaux. Pour spécifier une tabulation, indiquez « tab », « \t » ou « \x09 ».
/dlSpé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.
/dmSpécifie une description dans la barre de titre du côté milieu, tout comme
/dl.
/drSpécifie une description dans la barre de titre du côté droit, tout comme
/dl.
/alFusionne automatiquement sur le côté gauche au démarrage.
/amFusionne automatiquement sur le côté milieu au démarrage.
/arFusionne automatiquement sur le côté droit au démarrage.
/noninteractiveExé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.
/noprefsExécute WinMerge sans charger ni enregistrer les paramètres du registre. Toutes les comparaisons utilisent uniquement les préférences par défaut.
/enableexitcodeDéfinit le résultat de la comparaison comme code de sortie du processus. 0 : identique, 1 : différent, 2 : erreur
/ignorewsContrô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.
/ignoreblanklinesContrô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.
/ignorecaseContrô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.
/ignoreeolContrô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).
/ignorecodepageContrô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.
/ignorecommentsContrô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-fichierSpécifie une extension de fichier pour déterminer la coloration syntaxique.
/cfg nom=valeurDé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_gaucheSpécifie le dossier, le fichier ou le fichier de projet à ouvrir sur le côté gauche.
chemin_milieuSpécifie le dossier, le fichier ou le fichier de projet à ouvrir sur le côté milieu.
chemin_droiteSpé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 et
chemin_milieu) 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.chemin_droite
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_sortieSpé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_conflitSpé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_inispécifie un fichier INI utilisé pour charger et enregistrer les paramètres au lieu du registre.