Sfruttando le potenzialità dei monitor a colori, KDiff3 evidenzia accuratamente le differenze. Quando dovrai fare molte revisioni di codice, apprezzerai questo aiuto.

Saranno ben visibili spazi e tabulatori che risultano diversi. Quando le righe differiscono soltanto per uno spazio, lo si potrà subito vedere nella colonna di sommario sul lato sinistro (non dovrai più preoccuparti quando qualcuno cambia l'indentazione).

Analizza tre file e verifica dove differiscono.

Le finestre sinistra, centrale e destra si chiamano A, B e C ed hanno rispettivamente i colori blu, verde e magenta.

Se per una riga due file sono uguali ed un altro è diverso, il colore indica quello diverso. Il colore rosso significa che tutti i file sono diversi.

KDiff3 può essere usato per fondere due o tre file di ingresso e fonderli automaticamente il più possibile. Il risultato è presentato in una finestra di modifica dove la maggior parte dei conflitti possono essere risolti con un semplice clic del mouse: seleziona i relativi pulsanti ... nelle finestre di A, B e C per selezionare la sorgente da usare. È possibile anche selezionare più di una sorgente. Dato che questa finestra è un editor, qui si possono risolvere anche i conflitti che hanno bisogno di ulteriori correzioni, senza bisogno di altri strumenti.

Sopra ad ogni finestra di testo c'è una «riga informativa». Queste contengono una lettera A, B o C, il nome del file modificabile, un pulsante per la navigazione e il numero della prima riga visibile nella finestra (nota che C è opzionale). Ogni riga informativa appare con un colore diverso.

Quando hai selezionato un altro file con la navigazione, o hai finito di modificare il nome di un file premendo Invio, il nuovo file verrà caricato e confrontato con i file già caricati.

Alle tre finestre di ingresso sono assegnate le lettere A, B e C. A è colorata di blu, B di verde e C di magenta. Questi sono i colori predefiniti, ma puoi cambiarli nell'elemento Colore nella finestra di dialogo delle impostazioni.

Quando si trova una differenza, il colore mostra quale file di ingresso differisce. Quando entrambi gli altri file di ingresso differiscono, il colore usato per evidenziare la situazione sarà il rosso (opzione Colore per i conflitti nell'elemento Colore nella finestra di dialogo delle impostazioni). Questo schema di colori è molto utile nel caso di tre file di ingresso, che discuteremo nella prossima sezione (Fusione).

A sinistra di ogni testo è presente la colonna di «riepilogo». Se ci sono differenze su una riga, la colonna di riepilogo ne mostrerà il colore corrispondente. Nel riepilogo le differenze di soli spazi saranno evidenziate con una griglia. Per i linguaggi di programmazione in cui gli spazi non sono importanti è molto utile notare a colpo d'occhio se è stato cambiato qualcosa di importante (in C e C++ gli spazi sono importanti solamente dentro a stringhe, commenti, direttive al preprocessore e poche altre situazioni molto particolari).

La linea verticale che separa la colonna di riepilogo e il testo è interrotta se il file di ingresso non presenta righe in questo punto. Quando è attivato il ritorno a capo, questa linea verticale sarà punteggiata in corrispondenza delle righe mandate a capo.

Sul lato destro, a sinistra della barra di scorrimento, si può vedere una colonna «riassuntiva». Essa mostra sinteticamente la colonna di sommario dell'ingresso A. Tutte le differenze e i conflitti sono visibili a colpo d'occhio. Quando si usano solo due finestre di ingresso, tutte le differenze appaiono in rosso, perché ogni differenza è un conflitto. Un rettangolo nero incornicia la parte visibile dell'ingresso. Per file di ingresso molto lunghi, quando il numero delle righe è maggiore dell'altezza in pixel della colonna riassuntiva, più righe di ingresso condividono una riga di riassunto. Qui un conflitto ha maggiore priorità rispetto alle semplici differenze, che hanno priorità sul caso di nessuna modifica, così che nessuna differenza o conflitto viene perso. Facendo clic su questa colonna riassuntiva ne verrà visualizzato il testo corrispondente.

A volte l'algoritmo affianca le linee sbagliate. Oppure vuoi confrontare un estratto di testo con del testo in una posizione completamente diversa nell'altro file. Per queste situazioni puoi ordinare manualmente a KDiff3 di allineare certe righe. Seleziona il testo per il quale vuoi migliorare l'allineamento con il mouse, come se volessi copiare e incollare nella prima vista delle differenze, e quindi scegli l'elemento di menu Vista di confronto → Aggiungi allineamento manuale delle differenze (scorciatoia da tastiera Ctrl+Y). Apparirà una barra arancione nella colonna panoramica di fianco al testo scelto. Ripeti l'operazione per la seconda e (se disponibile) terza vista delle differenze. KDiff3 ricalcolerà immediatamente le differenze ogni volta che lo farai, e allineerà automaticamente le righe scelte. Naturalmente qualcuna delle righe selezionate in precedenza potrebbe non corrispondere più.

Attualmente la fusione non supporta l'uso dell'aiuto per le differenze manuali.

In alcuni casi KDiff3 vedrà troppe o troppo poche sezioni di differenze per la fusione. In questo caso puoi unire o dividere le sezioni esistenti.

Aggiungi le nuove sezioni selezionando per prima cosa del testo nelle righe corrispondenti in una delle finestre di ingresso (come quando si copia negli appunti). Scegli quindi l'elemento di menu Fondi → Dividi differenze alla selezione. Le divisioni saranno aggiunte sopra la prima riga e sotto l'ultima del testo selezionato. Se vuoi aggiungere solo una sezione, seleziona il testo partendo da un'altra divisione di sezioni.

Per unire le sezioni in una delle finestre di ingresso, seleziona qualcosa nelle righe che vuoi unire. Puoi anche unire diverse sezioni in un colpo solo. Seleziona quindi l'elemento di menu Fondi → Unisci le differenze selezionate.

La finestra di modifica del risultato di fusione ha anche una colonna di sommario sulla sinistra. Essa mostra la lettera dell'input da dove la riga è stata selezionata o nulla se tutte le tre sorgenti hanno la stessa riga. Per i conflitti essa mostra un punto interrogativo "?" e la riga mostra "<Conflitto nel fondere>", tutto in rosso. Dato che risolvere conflitti riga per riga richiede molto tempo, le righe sono raggruppate per gruppi con le stesse caratteristiche di differenza e conflitto. Saranno separati solo i conflitti di spazi bianchi dai conflitti di spazi non bianchi in modo da facilitare la fusione dei file in cui l'indentazione, su molte righe, cambia.

Quando si fa clic sulla colonna di sommario col tasto sinistro del mouse in una finestra, l'inizio del gruppo appartenente a quella riga sarà selezionato in tutte le finestre. Questo gruppo diverrà il «gruppo attuale». Esso è evidenziato con l'opzione Colore di fondo per questo intervallo attuale dell'elemento Integrazione nella finestra di dialogo delle impostazioni e una barra nera apparirà sul lato sinistro del testo.

La barra dei pulsanti sotto la barra dei menu contiene tre pulsanti di selezione degli input contenenti le lettere A, B e C. Fai clic nel pulsante di selezione input per inserire (o rimuovere se già inserite) le righe dalle rispettive sorgenti. Per scegliere le righe da più input fai clic nei rispettivi pulsanti nell'ordine necessario. Per esempio se vuoi che nell'output le righe della B appaiano prima delle righe della A, fai prima clic su B quindi su A.

Se usi il pulsante Vai automaticamente al prossimo conflitto non risolto dopo la selezione del sorgente (vedi la sezione Avanzamento automatico), dovresti disabilitarla prima di scegliere le righe da diversi input o se vuoi modificare le righe dopo aver scelto. Altrimenti KDiff3 salterà al prossimo conflitto dopo aver scelto il primo input.

È spesso molto utile modificare direttamente l'output della fusione. La colonna di sommario mostrerà "m" per ogni riga che viene modificata manualmente. Quando per esempio le differenze sono allineate in modo che scegliere semplicemente gli input non sia soddisfacente, allora puoi marcare il testo necessario e usare il normale copia e incolla per inserirlo nell'output di fusione.

Alcune volte, quando una riga viene rimossa dalla fusione automatica o da una modifica manuale e non rimangono altre righe nel gruppo, allora apparirà in questa riga il messaggio <Riga sorgente mancante>. Questa posizione verrà mantenuta dal gruppo nel caso tu cambiassi idea e volessi sezionare qualche altro sorgente. Questo testo non verrà reimmesso nel file salvato o in altre selezioni che desideri copiare ed incollare.

Il testo "<Fondi conflitti>" apparirà negli appunti se copi ed incolli del testo contenente questa riga. Fai comunque attenzione nell'eseguire tale operazione.

La normale fusione inizierà risolvendo semplici conflitti automaticamente. Ma il menu Fondi permette altre azioni per altre necessità comuni. Se devi selezionare lo stesso sorgente per molti conflitti, potrai selezionare sempre A, B o C, o solamente per i conflitti non risolti restanti, o per i conflitti di spazi bianchi non risolti. Se vuoi decidere tu stesso ogni singola differenza, puoi Impostare le differenze come conflitti, o se vuoi ritornare all'opzione automatica di KDiff3 seleziona Risolvi automaticamente i conflitti semplici. KDiff3 riavvierà quindi la fusione. Per azioni che cambiano le tue precedenti modifiche KDiff3 ti chiederà conferma prima di procedere.

Molti sistemi di controllo di versione supportano parole chiave speciali nel file. (es. "$Date$", "$Header$", "$Author$", "$Log$", ecc.) Durante il controllo il sistema di controllo di versione (VCS) cambia queste righe. Per esempio "$Date$" cambierà in "$Date: 2005/03/22 18:45:01 $". Dato che questa riga sarà diversa in ogni versione del file, richiederà l'interazione manuale durante la fusione.

KDiff3 offre la fusione automatica per questi elementi nell'elemento Fondi nella finestra di dialogo delle impostazioni. Per righe semplici che corrispondono all'opzione Fondi automaticamente le espressioni regolari in tutti i file di input KDiff3 sceglierà la riga da B o - se disponibile - da C (è inoltre necessario che le righe in questione corrispondano nel confronto e la riga precedente non contenga alcun conflitto). Questa fusione automatica può essere avviata sia immediatamente dopo l'avvio della fusione (attiva l'opzione Avvia la fusione automatica delle espressioni regolari all'avvio di fusione) o in un secondo momento attraverso l'elemento di menu Fondi → Avvia la fusione automatica delle espressioni regolari.

È supportata anche la fusione automatica per la cronologia del controllo di versione (nota anche come «registro»). La fusione automatica della cronologia può essere eseguita immediatamente all'avvio della fusione attivando l'opzione Fondi la cronologia del controllo di versione all'inizio della fusione dell'elemento Fondi nella finestra di dialogo delle impostazioni, o successivamente tramite l'elemento di menu Fondi → Risolvi automaticamente i conflitti di cronologia.

Normalmente la cronologia del controllo di versione comincia con una riga contenente la parola chiave "$Log$". Questa deve essere corrisposta dall'opzione Espressione regolare dell'inizio di cronologia. KDiff3 rileva quali righe successiva sono nella cronologia analizzando i caratteri iniziali che precedono la parola chiave "$Log$". Se gli stessi caratteri di «commento iniziale» appaiono anche nelle righe seguenti, anche queste verranno incluse nella cronologia.

Durante il deposito, il VCS scrive una riga univoca che specifica informazioni di versione, data e ora, seguite da righe con commenti dell'utente. Queste righe costituiscono un elemento della cronologia. Questa sezione di cronologia cresce a ogni deposito, e le voci più recenti sono in cima (dopo la riga di inizio della cronologia).

Quando, in sviluppo parallelo, due o più sviluppatori depositano un ramo del file, la cronologia di fusione conterrà diversi elementi che risultano come conflitti durante la fusione dei rami. Siccome fonderli può essere molto noioso, KDiff3 offre aiuto con due possibili strategie: basta che inserisci le informazioni sulla cronologia da entrambi gli sviluppatori in cima o ordini le informazioni della cronologia secondo una chiave definita dall'utente.

Il metodo «inserisci tutti gli elementi e basta» è più facile da configurare. KDiff3 ha bisogno solo di un metodo per rilevare quali righe appartengano a un elemento di cronologia. La maggior parte dei VCS inserisce una riga vuota dopo ogni elemento di cronologia. Se non ci sono altre righe vuote, questo è un criterio sufficiente per KDiff3. Basta che imposti una Espressione regolare di inizio dell'elemento di cronologia vuota nell'elemento Fondi nella finestra di dialogo delle impostazioni. Se il criterio della riga vuota non è sufficiente, puoi specificare un'espressione regolare per rilevare l'inizio degli elementi di cronologia.

Nota che KDiff3 rimuoverà gli elementi di cronologia duplicati. Se un elemento di cronologia compare diverse volte nella cronologia di un file di ingresso, ne rimarrà solo uno nell'uscita.

Se vuoi ordinare la cronologia, devi specificare come costruire la chiave di ordinamento. Usa le parentesi nella Espressione regolare di inizio dell'elemento di cronologia nell'elemento Fondi nella finestra di dialogo delle impostazioni per raggruppare parti dell'espressione regolare che dovrebbero essere usate in seguito per la chiave di ordinamento. Specifica quindi l'opzione Ordine della chiave d'ordinamento d'inizio degli elementi della cronologia, specificando un elenco, separato da «virgole», di numeri che si riferiscono alla posizione del gruppo nell'espressione regolare.

Siccome questo non è così facile da azzeccare al primo colpo, devi poter provare e migliorare le espressioni regolari e la generazione delle chiavi in una finestra apposita premendo il pulsante Prova le espressioni regolari.

Esempio. Prendi in considerazione una cronologia che assomiglia a questa:

/**************************************************************************
** HISTORY:    $Log: \toms_merge_main_view\MyApplication\src\complexalgorithm.cpp $
**
**     \main\integration_branch_12   2 Apr 2001 10:45:41   tom
**  Fuso il ramo simon_branch_15.
**
**     \main\henry_bugfix_branch_7\1   30 Mar 2001 19:22:05   henry
**  Migliorata la velocità della funzione convertToMesh().
**  Crash corretto.
**************************************************************************/

La riga di inizio della cronologia corrisponde all'espressione regolare ".*\$Log.*\$.*". Seguono quindi le voci della cronologia.

La riga con la parola chiave "$Log$" comincia con due «*» dopo i quali segue uno spazio. KDiff3 usa la prima stringa non di spazi come «commento iniziale» e assume che la cronologia si concluda nella prima riga senza questo commento iniziale. In questo esempio l'ultima riga finisce con una stringa che comincia anch'essa con due «*», ma invece di un carattere di spaziatura seguono degli altri «*». Perciò questa riga conclude la cronologia.

Se l'ordinamento della cronologia non è necessario, l'espressione regolare dell'inizio degli elementi di cronologia potrebbe avere questo aspetto (questa riga è divisa in due parti per ragioni di spazio):

\s*\\main\\\S+\s+[0-9]+ (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)
 [0-9][0-9][0-9][0-9] [0-9][0-9]:[0-9][0-9]:[0-9][0-9]\s+.*

Per dettagli sulle espressioni regolari, vedi la documentazione sulle espressioni regolari. Nota che "\s" (con la minuscola) corrisponde ai caratteri di spaziatura e "\S" (con la maiuscola) corrisponde a qualsiasi carattere non di spaziatura. Nell'esempio l'inizio degli elementi di cronologia contiene prima le informazioni di versione, con espressione regolare "\\main\\\S+", la data in forma di giorno "[0-9]+", mese "(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)" e anno "[0-9][0-9][0-9][0-9]", l'ora "[0-9][0-9]:[0-9][0-9]:[0-9][0-9]" e infine il nome dello sviluppatore ".*".

Nota che i caratteri di «commento iniziale» (nell'esempio "**") saranno già rimossi da KDiff3 prima del confronto, quindi l'espressione regolare comincia con una corrispondenza per zero o più caratteri di spaziatura, "\s*". Siccome i caratteri dei commenti possono essere diversi in ogni file (per esempio, C e C++ usano dei caratteri diversi rispetto a Perl), KDiff3 si prende cura dei caratteri iniziali dei commenti, e tu non devi specificarli nell'espressione regolare.

Se hai bisogno di una cronologia ordinata, deve essere calcolata la chiave di ordinamento. Per farlo, le parti rilevanti dell'espressione regolare devono essere raggruppate in parentesi (le parentesi aggiuntive possono essere lasciate se l'ordinamento della cronologia viene disabilitato).

\s*\\main\\(\S+)\s+([0-9]+) (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)
 ([0-9][0-9][0-9][0-9]) ([0-9][0-9]:[0-9][0-9]:[0-9][0-9])\s+(.*)

Le parentesi contengono ora: 1. informazioni di versione, 2. giorno, 3. mese, 4. anno, 5. ora, 6. nome. Se vogliamo ordinare per data e ora, dobbiamo costruire una chiave con gli elementi in un altro ordine di apparizione: prima l'anno, poi il mese, il giorno, l'ora, le informazioni di versione e il nome. Quindi, la chiave di ordinamento da specificare è "4,3,2,5,1,6".

Siccome i nomi dei mesi non sono facili da ordinare ("Apr" sarebbe il primo), KDiff3 rileva l'ordine in cui i nomi dei mesi sono stati dati e usa quell'ordine ("Apr" -> "04"). Se viene trovato un numero, verrà trasformato in un valore a quattro cifre con zeri iniziali per l'ordinamento. Infine, la chiave di ordinamento risultante per la prima riga di inizio degli elementi di cronologia sarà:

2001 04 0002 10:45:41 integration_branch_12   tom

Per ulteriori informazioni vedi anche la sezione Impostazioni di fusione.

C'è anche un pulsante Vai automaticamente al prossimo conflitto non risolto dopo aver selezionato la fonte (avanzamento automatico). Se lo usi, quando una fonte è selezionata, KDiff3 passerà e selezionerà il prossimo conflitto non risolto automaticamente. Ciò è d'aiuto quando vuoi sempre scegliere un solo file di ingresso. Quando hai bisogno di entrambe le fonti, o vuoi cambiare qualcosa dopo aver selezionato, probabilmente lo vorrai disattivare. Prima di procedere al prossimo conflitto non risolto, KDiff3 mostrerà l'effetto della tua scelta per un breve periodo. Questo tempo è regolabile nell'elemento Fondi nella finestra di dialogo delle impostazioni. Puoi specificare il Ritardo nell'avanzamento automatico (ms) in millisecondi tra i valori 0 e 2000. Se vuoi ridurre il numero di volte che fai clic, usa un ritardo di avanzamento breve e le scorciatoie Ctrl+1, Ctrl+2 e Ctrl+3 per selezionare A, B e C nel caso di molti conflitti.

Seleziona un carattere a larghezza fissa. Su alcuni sistemi questa finestra potrebbe presentare anche caratteri a larghezza variabile, ma non dovresti usarli.

Il cambio dei colori per il confronto tra cartelle avrà effetto solo all'avvio del prossimo confronto tra cartelle.

Su sistemi con soli 16 o 256 colori, alcuni colori non sono disponibili nella forma esatta. In questi sistemi il pulsante Valori predefiniti selezionerà un colore puro.

Nel confronto dei file, KDiff3 prova prima a confrontare le righe uguali in tutti i file di ingresso. Solo durante questa fase potrebbe ignorare gli spazi. La seconda fase confronta ogni riga. In questa fase gli spazi non saranno ignorati. Anche durante la fusione gli spazi non saranno ignorati.

Queste opzioni riguardano la scansione delle cartelle e la gestione della fusione: vedi la documentazione sul confronto e la fusione tra cartelle per maggiori dettagli.

Tuttavia, qui c'è un'opzione di rilievo anche per il salvataggio di file singoli:

Queste opzioni e azioni sono disponibili nei menu o nelle barre dei pulsanti.

Attualmente solo la versione Frameworks supporta la configurazione personalizzata delle scorciatoie da tastiera (menu Impostazioni → Configura le scorciatoie).

Questa sezione spiega sommariamente alcune funzionalità elementari di sed. Per maggiori informazioni vedi info:/sed o https://www.gnu.org/software/sed/manual/html_mono/sed.html. Puoi trovare una versione di sed precompilata per Windows® a http://unxutils.sourceforge.net. Nota che gli esempi seguenti danno per scontato che sed sia in una cartella compresa nella variabile d'ambiente PATH. Se ciò non fosse, dovrai specificare il percorso completo del comando.

In questo contesto viene utilizzato solo il comando sostitutivo sed:

sed 's/ESPR.REG./SOSTITUZIONE/FLAG'

Prima di usare un nuovo comando all'interno di KDiff3, dovresti prima testarlo in una console. Qui torna utile il comando echo. Esempio:

echo abrakadabra | sed 's/a/o/'
   -> obrakadabra

Questo esempio mostra un comando sed molto semplice che sostituisce la prima occorrenza di «a» con «o». Se volessi sostituire tutte le occorrenze, dovresti invece utilizzare il flag «g»:

echo abrakadabra | sed 's/a/o/g'
   -> obrokodobro

Il simbolo «|» è il comando di incanalamento che trasferisce il risultato del comando precedente all'ingresso del comando successivo. Se vuoi eseguire una prova con un file più lungo, puoi utilizzare cat nei sistemi tipo UNIX® o type in quelli Windows®. sed eseguirà la sostituzione per ciascuna riga.

cat nome_file | sed opzioni

I dati sono incanalati attraverso tutti i preprocessori interni ed esterni nel seguente ordine:

I dati, dopo essere passati dal preprocessore normale, saranno tenuti per la visualizzazione e la fusione. Le altre operazioni modificano solo i dati visti dall'algoritmo che rileva le differenze tra le righe corrispondenti.

Nei rari casi in cui si usa il preprocessore normale, bisogna tener presente che il preprocessore di corrispondenza delle righe vede l'uscita del preprocessore normale come proprio ingresso.

I comandi di preprocesso sono spesso utilissimi, ma, come per ogni opzione che modifichi il testo o che nasconda automaticamente certe differenze, possono far sfuggire certe differenze, o nel peggiore dei casi distruggere dati importanti.

Per questa ragione, se durante una fusione è in funzione un comando del preprocessore normale, KDiff3 te lo dirà e ti chiederà se vuoi disattivarlo. Però non ti avviserà se è attiva l'opzione Preprocessore per il confronto di righe:. La fusione non sarà completata finché non saranno risolti tutti i conflitti. Se hai disabilitato l'elemento di menu Vista di confronto → Mostra spazi, anche le differenze che sono state rimosse con l'opzione Preprocessore per il confronto di righe: saranno invisibili. Se il pulsante Salva resta disattivato durante una fusione (perché sussistono dei conflitti), assicurati di attivare l'elemento di menu Vista di confronto → Mostra spazi. Se non vuoi fondere manualmente queste differenze meno importanti, puoi selezionare l'elemento di menu Fondi → Scegli [A|B|C] per tutti i conflitti di spazi non risolti.

kdiff3 cartella1 cartella2
   kdiff3 cartella1 cartella2 -o  cartella_destinazione

Se non viene specificata una cartella di destinazione, KDiff3 userà cartella2.

kdiff3 cartella1 cartella2 cartella3
   kdiff3 cartella1 cartella2 cartella3 -o cartella_destinazione

Quando si fondono tre cartelle, cartella1 viene usata come base della fusione. Se non è stata specificata alcuna cartella di destinazione per la fusione, KDiff3 userà cartella3.

Nota che solo il confronto inizia automaticamente, non la fusione. Per farla devi prima selezionare un elemento del menu o il tasto F7 (maggiori dettagli di seguito).

Ogni file e cartella trovato durante la scansione è mostrato qui in un albero. Puoi selezionare un elemento facendoci clic con il mouse.

Normalmente le cartelle sono chiuse. È possibile espanderle e richiuderle con un clic su + o - rispettivamente, facendo doppio clic sull'elemento, o usando i tasti ← o →. Il menu Cartella contiene inoltre due azioni, Chiudi tutte le sottocartelle e Apri tutte le sottocartelle con le quali puoi richiudere o espandere tutte le cartelle in una sola volta.

Se fai doppio clic su un file, il confronto verrà avviato e apparirà la finestra delle differenze dei file.

L'immagine nella colonna del nome corrisponde al tipo di file nella prima cartella (A). Può essere una di queste:

Se il tipo di file è diverso nelle altre cartelle, questo è visibile nelle colonne A, B e C e nella finestra che mostra i dettagli dell'elemento selezionato. Nota che in questo caso nessuna operazione di fusione potrà essere selezionata automaticamente. Quando la fusione sarà avviata, l'utente sarà informato dei problemi di questo tipo.

Come si può vedere nell'immagine sopra, i colori rosso, verde, giallo e nero sono utilizzati nelle colonne A, B e C.

Per gli elementi risultati identici dal confronto, il colore è identico anche se l'età non lo è.

Le cartelle sono considerate uguali se tutti gli elementi in esse contenuti sono identici. In tal caso avranno anche lo stesso colore. L'età di una cartella, però, non è considerata per il suo colore.

L'idea di questo schema di colorazione l'ho avuta dal comando dirdiff. I colori sembrano i colori di una foglia, che è verde quando è nuova, successivamente ingiallisce e diventa rossa quando è vecchia.

Dopo aver confrontato le cartelle, KDiff3 valuta anche una proposta di fusione. Questa è visibile nella colonna Operazione. Puoi modificare l'operazione facendo clic su quella che desideri cambiare. Apparirà un piccolo menu che permetterà di selezionare un'operazione per quell'elemento. Puoi anche selezionare le operazioni necessarie con la tastiera: Ctrl+1, Ctrl+2, Ctrl+3, Ctrl+4, e Ctrl+Canc selezionano rispettivamente, A, B, C, Fondi ed Elimina, se disponibili. Questa operazione verrà eseguita durante la fusione. Quali operazioni sono disponibili dipende dall'elemento e dalla modalità di fusione attuale. La modalità di fusione è una tra le seguenti:

Nella fusione di tre cartelle l'operazione proposta sarà: Se per un elemento…

Nella fusione di due cartelle l'operazione proposta sarà: se per un elemento…

La modalità di sincronizzazione è attiva se solo sono state specificate due cartelle e nessuna destinazione, e se è attiva l'opzione Sincronizza cartelle. KDiff3 selezionerà quindi un'operazione predefinita in modo che entrambe le cartelle divengano successivamente uguali. Se per un elemento…

Quando due cartelle vengono fuse ed è selezionata l'opzione Copia il più recente invece di fondere (non sicuro), KDiff3 verificherà le date e proporrà di scegliere il file più recente. Se i file non sono uguali ma hanno la stessa data, il risultato dell'operazione sarà «Errore: le date coincidono ma i file sono diversi». La fusione delle cartelle non può essere avviata finché esistono questi elementi.

Durante la fusione i file saranno elaborati uno per volta. La colonna di stato indicherà Fatto per gli elementi correttamente fusi, e altri messaggi se si è verificato qualche imprevisto. Quando una fusione è completa, si dovrebbe fare un'ultima verifica per vedere se gli stati di tutti gli elementi sono corretti.

Quando la modalità di confronto dei file Analisi completa è stata abilitata nelle opzioni, KDiff3 mostrerà delle colonne supplementari con il numero di conflitti non risolti, risolti, di spazi vuoti e non (la colonna Risolto sarà mostrata solo quando si confrontano o fondono tre cartelle).

Diverse opzioni influenzano quali file vengono qui elencati. Ad alcune si può accedere nella finestra delle impostazioni. Il menu Cartella contiene le voci:

Attiva le opzioni di visualizzazione solo per gli elementi che vuoi elencare. Se per esempio vuoi solo elencare tutti gli elementi che esistono in A o B, ma non in entrambi, dovrai attivare Mostra file solo in A e Mostra file solo in B, e disattivare tutti gli altri (Mostra file identici, Mostra file diversi, Mostra file solo in C). L'elenco sarà immediatamente aggiornato secondo le modifiche.

Queste opzioni valgono anche per le cartelle, con un'eccezione: disabilitare Mostra file diversi non nasconderà le cartelle complete, ma funzionerà solo per i loro file.

Nota che tra queste opzioni solo Mostra file identici è persistente; le altre sono abilitate quando si avvia KDiff3.

Normalmente l'elenco di visualizzazione della fusione delle cartelle rimane visibile mentre un file viene confrontato o fuso. Con il mouse puoi muovere la barra di separazione tra l'elenco dei file e le finestre delle differenze testuali. Se non lo vuoi, puoi disabilitare l'elemento di menu Cartella → Vista separata di cartelle e testi. Potrai quindi usare l'elemento di menu Cartella → Cambia vista per passare tra l'elenco di file e la vista delle differenze, che quindi occuperà tutto lo schermo.

Probabilmente è più semplice fare doppio clic col mouse su un file per confrontarlo; esiste però anche una voce nel menu Cartella. Puoi anche fondere direttamente un file singolo selezionandolo e scegliendo l'elemento di menu Fondi → Fondi il file attuale. Al salvataggio del risultato, lo stato del file verrà segnato come completato, e il file non verrà fuso di nuovo se viene avviata una fusione tra cartelle.

Nota però che queste informazioni di stato andranno perse se esegui nuovamente una scansione delle cartelle con Cartella → Riesamina.

A volte devi confrontare o fondere file con nomi diversi, per esempio un file e la sua copia di sicurezza nella stessa cartella.

Seleziona il file facendo clic sull'icona nella colonna A, B o C. Il primo file selezionato sarà segnato con A, il secondo e il terzo con B e C indipendentemente dalla colonna in cui si trovano. Si possono scegliere tre file al massimo in questo modo.

Procedi scegliendo l'elemento di menu Cartella → Confronta file selezionati esplicitamente o Cartella → Fondi file selezionati esplicitamente. Per comodità, queste voci appaiono anche nel menu contestuale quando fai clic destro sull'ultimo file selezionato.

Il confronto o la fusione di un file avverrà nella stessa finestra. Se questo metodo viene usato per le cartelle, sarà aperta una nuova finestra.