Manuale di KDiff3
KDiff3 è uno strumento per verificare differenze ed eseguire fusioni tra file e directory, il quale
confronta e fonde due o tre file di testo o directory in ingresso,
mostra la loro differenza linea per linea o carattere per carattere(!),
fornendo semplici automatismi per la fusione,
possiede un editor per la risoluzione dei conflitti di fusione,
rendendo trasparente la rete con l'uso di KIO,
ha opzioni per mostrare o nascondere le variazioni di spazi bianchi o di commenti.
Questo documento descrive la versione 0.9.80 di KDiff3.

Introduzione

Un'altra interfaccia per comparare file?
Per la comparazione dei file esistono numerosi strumenti grafici. Perché scegliere KDiff3? Lascia che ti dica perché l'ho scritto.
KDiff3 è nato perché dovevo eseguire una difficile fusione tra file. La fusione è necessaria quando molte persone, in un progetto, lavorano sugli stessi file. La fusione può essere piuttosto automatica, quando gli strumenti di fusione non solo permettono la modifica dei nuovi file ("rami") ma anche del file originale ("base"). Lo strumento per la fusione sceglierà automaticamente solo le modifiche eseguite all'interno di un ramo. Quando più persone cambiano le stesse righe, allora lo strumento di fusione trova un conflitto che dovrà essere risolto manualmente.
La fusione era quindi difficile in quanto uno aveva cambiato molte cose e corretto l'indentazione in molti punti. Un altro aveva inoltre variato molto testo in alcuni file, i quali risultavano in conflitto nell'operazione di fusione.
Lo strumento che utilizzai mostrava solamente le linee variate, ma non cosa era cambiato all'interno di esse. Inoltre non c'era nessuna informazione riguardo la variazione di indentazione. La fusione era un piccolo incubo.
Così fu l'inizio. La prima versione poteva mostrare le differenze all'interno di una riga e la differenza degli spazi bianchi. Successivamente molte altre caratteristiche furono introdotte per aumentarne l'utilità.
Per esempio se vuoi comparare velocemente alcuni testi, è possibile copiarne il contenuto negli appunti, quindi incollarlo in una finestra di KDiff3.
Una caratteristica che ha richiesto un grosso sforzo è stata la comparazione tra directory e la funzione di fusione, le quali hanno trasformato il programma in un vero e proprio navigatore di file.
Spero che KDiff3 sia utile anche a te. Divertiti!
Joachim Eibl (2003)

Schermate e caratteristiche
Questa schermata mostra la differenza tra due file di testo
(Usando una versione recente di KDiff3):
È supportata la fusione di tre file. Questa è particolarmente utile se due persone variano indipendentemente il codice. Il file originale (il file base) è utilizzato per aiutare KDiff3 a selezionare automaticamente i corretti cambiamenti. Sotto le finestre che evidenziano le differenze una finestra di modifica ti permetterà di risolvere i conflitti riscontrati, mostrandone il risultato ottenuto. Potrai inoltre modificare il risultato delle operazioni. Questa schermata mostra il risultato di fusione di tre file in ingresso:
KDiff3 aiuta anche a comparare e fondere intere directory. Questa schermata mostra KDiff3 durante una fusione di directory:

Altre caratteristiche

Indicazione delle differenze per riga e per carattere
Utilizzando tutte le visualizzazioni grafiche a colori, KDiff3 visualizza esattamente qual'è la differenza. Quando hai la necessità di fare molte revisioni di codice, gradirai questo.

Vedere le differenze di spazi bianchi a colpo d'occhio
Saranno visibili spazi e tabulatori che risultano diversi. Quando le linee differiscono solamente di uno spazio bianco questo potrà essere subito visibile nella colonna di sommario posizionata sul lato sinistro. (Non preoccuparti più quando le persone cambieranno l'indentazione.)

Verifica con tre file
Analizza tre file e verifica dove differiscono.
Le finestre sinistra/centrale/destra si chiamano A/B/C ed hanno rispettivamente il colore /blu/verde/magenta.
Se un file è uguale ed un altro è diverso in una linea allora il colore mostrerà come è diverso. Il colore rosso significa che entrambi gli altri file sono diversi.

Comoda fusione di due o tre file di input
KDiff3 può essere usato per fondere due o tre file di ingresso ed automaticamente fonde quanto è possibile. Il risultato è presentato in una finestra di modifica dove molti conflitti possono essere risolti con un semplice clic del mouse: Selezionando i pulsanti A/B/C dalla barra si seleziona la sorgente che deve essere utilizzata. È possibile selezionare più di un file sorgente. Dato che questa finestra è un editor anche i conflitti che hanno bisogno di ulteriori correzioni possono essere qui risolti senza bisogno di un altro strumento.

Inoltre ...
Pulsanti per la navigazione veloce.
Un clic del mouse nella colonna di sommario sincronizzerà tutte le finestre per mostrare la stessa posizione.
Seleziona e copia da una qualsiasi finestra ed incolla nella finestra del risultato di fusione.
Colonna che mostra dove sono i cambiamenti ed i conflitti.
È possibile impostare i diversi colori secondo le tue specifiche esigenze.
Dimensione della tabulazione modificabile.
Opzione per inserire spazi invece che tabulatori.
È possibile aprire i file comodamente dalla finestra di dialogo oppure specificandoli sulla riga di comando.
Ricerca stringhe in tutto il testo della finestra. Trova (Ctrl-F) e Trova Successivo (F3)
Mostra il numero di riga per ogni riga.
Incolla dagli appunti o trascina il testo nella finestra di KDiff3.
Trasparenza di rete tramite KIO.
Può essere utilizzato come visualizzatore delle differenze in Kdevelop 3.
...