# Manuale di &kdiff3;

Michael
Reeves

     reeves.87@gmail.com

Joachim
Eibl

     joachim.eibl@gmx.de

Stelvio
Rosset
Traduzione della documentazione, 2004
Marcello
Anni
Aggiornamento e revisione della traduzione, 2007
Federico
Zenith

    federico.zenith@member.fsf.org

Aggiornamento della traduzione, 2009
Valter
Mura

    valtermura@gmail.com

Aggiornamento della traduzione, 2018
2002-2007
Joachim Eibl
2017-2019
Michael Reeves
&FDLNotice;
2019-02-22
1.08.02

&kdiff3; è uno strumento per verificare le differenze ed eseguire fusioni tra file e cartelle, che:

- confronta e fonde due o tre file di testo o cartelle in ingresso,

- ne mostra le differenze riga per riga o carattere per carattere,

- dà un modo semplice per fonderli,

- ha un editor per risolvere comodamente i conflitti di fusione,

- supporta la trasparenza di rete tramite KIO,

- ha delle opzioni per evidenziare o nascondere le differenze costituite da spazi o commenti nel codice,

- supporta Unicode, UTF-8 e altre codifiche,

- stampa le differenze,

- supporta la fusione delle parole chiave del controllo di versione e della cronologia.

Questo documento descrive la versione 1.8 di &kdiff3;.

KDE
kdiff3
differenze
fusione
CVS
confronto tra tre file
confronta
file
cartelle
controllo di versione
fusione di tre file
differenze in riga
sincronizza
kpart
kio
trasparenza di rete
editor
spazio
commenti

## Introduzione

### Un'altra interfaccia per confrontare file?

Per il confronto dei file esistono numerosi strumenti grafici. Perché dovresti scegliere &kdiff3;? Lascia che ti spieghi perché l'ho scritto.

&kdiff3; è nato perché dovevo eseguire una difficile fusione tra file. La fusione è necessaria quando più persone lavorano sugli stessi file in un progetto. La fusione può essere per lo più 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.

In quel caso la fusione era difficile in quanto un collaboratore aveva cambiato molte cose e corretto l'indentazione in molti punti. Inoltre, un altro aveva cambiato molto testo nello stesso file, dando luogo a molti conflitti durante l'operazione di fusione.

Lo strumento che usavo a quel tempo mostrava solamente le righe modificate, ma non cosa era cambiato dentro di loro. Inoltre non c'erano informazioni su dove fosse cambiata solo l'indentazione. La fusione fu un piccolo incubo.

Così fu l'inizio. La prima versione poteva mostrare le differenze all'interno di una riga e tra gli spazi. Successivamente molte altre funzionalità sono state introdotte per aumentarne l'utilità.

Per esempio, se vuoi confrontare velocemente alcuni testi, è possibile copiarne il contenuto negli appunti e quindi incollarlo in una delle finestre delle differenze.

Una funzionalità che ha richiesto molto lavoro è stato il confronto tra cartelle e la funzione di fusione, che hanno trasformato il programma quasi in navigatore di file completo.

Spero che &kdiff3; sia utile anche a te. Divertiti!

Joachim Eibl (2003)

### Schermate e funzionalità

Questa schermata mostra la differenza tra due file di testo

(Usando una vecchia versione di &kdiff3;):

La fusione di tre file è completamente supportata. Questa è particolarmente utile se due persone cambiano indipendentemente il codice. Si usa il file originale (la base) per aiutare &kdiff3; a selezionare automaticamente le modifiche giuste. Sotto le finestre che evidenziano le differenze, una finestra di modifica ti permetterà di risolvere i conflitti, mostrandone il risultato ottenuto. Puoi anche modificare il risultato delle operazioni. Questa schermata mostra il risultato della fusione di tre file in ingresso:

&kdiff3; ti aiuta anche a confrontare e fondere intere cartelle. Questa schermata mostra &kdiff3; durante una fusione tra cartelle:

### Altre funzionalità

#### Visore delle differenze per riga e per carattere

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

#### Vedere le differenze tra spazi a colpo d'occhio

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).

#### Confronto tra tre file

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.

#### Comoda fusione di due o tre file in ingresso

&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 pulsanti A, B e C dalla barra dei pulsanti 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.

#### Inoltre...

- Pulsanti per la navigazione veloce.

- Un clic del mouse nella colonna di sommario sincronizza tutte le finestre, facendo loro mostrare la stessa posizione.

- Seleziona e copia da una qualsiasi finestra ed incolla nella finestra del risultato della fusione.

- Colonna riassuntiva che mostra dove sono cambiamenti e conflitti.

- È possibile regolare i colori come vuoi.

- Dimensione regolabile delle tabulazioni.

- Opzione per inserire spazi invece che tabulatori.

- Apri i file comodamente da una finestra, oppure specificandoli dalla riga di comando.

- Ricerca di stringhe in tutto il testo della finestra. Trova (&Ctrl;F) e Trova Successivo (F3).

- Mostra il numero di ogni riga.

- Incolla dagli appunti o trascina il testo in una finestra di confronto.

- Trasparenza di rete tramite KIO.

- Può essere usato come visore delle differenze in KDevelop 3.

- A capo per righe lunghe.

- Supporto per Unicode, UTF-8 e altre codifiche.

- Supporto per le lingue scritte da destra a sinistra.

- ...

## Confronto e fusione file

### Opzioni da riga di comando

#### Confrontare due file:

    kdiff3 file1 file2

#### Fondere due file:

    kdiff3 file1 file2 -m
       kdiff3 file1 file2 -o file_di_uscita

#### Confrontare tre file:

    kdiff3 file1 file2 file3

#### Fondere tre file:

    kdiff3 file1 file2 file3 -m
       kdiff3 file1 file2 file3 -o file_di_uscita

Nota che file1 sarà trattato come la base di file2 e il file3.

#### Caso particolare: file con lo stesso nome

Se tutti i file hanno lo stesso nome, ma si trovano in cartelle diverse, è possibile specificare solamente il nome del primo file. Per esempio:

    kdiff3 cartella1/file cartella2 cartella3

#### Riga di comando per avviare un confronto o una fusione tra cartelle:

È molto simile, ma ora lavoriamo sulle cartelle.

    kdiff3 cartella1 cartella2
       kdiff3 cartella1 cartella2 -o cartella_destinazione
       kdiff3 cartella1 cartella2 cartella3
       kdiff3 cartella1 cartella2 cartella3 -o cartella_destinazione

Per maggiori informazioni sul confronto e fusione tra cartelle leggi qua.

#### Altre opzioni da riga di comando

Per vedere tutte le opzioni disponibili per la riga di comando scrivi:

    kdiff3 --help

Esempio di risultato:

    Opzioni:
      -m, --merge               Fondi l'input.
      -b, --base file           Fissa il file di base. Per compatibilità con alcuni programmi.
      -o, --output file         File di uscita. Implica -m. Es.: -o nuovofile.txt
      --out file                File di uscita (per compatibilità con alcuni programmi).
      --auto                    Senza interfaccia grafica se tutti i conflitti possono essere risolti automaticamente (richiede -o file).
      --qall                    Non risolve i conflitti automaticamente (per compatibilità).
      --L1 alias1               Sostituzione del nome visibile per file di ingresso 1 (base).
      --L2 alias2               Sostituzione del nome visibile per file di ingresso 2.
      --L3 alias3               Sostituzione del nome visibile per file di ingresso 3.
      -L, --fname alias         Sostituzione del nome visibile alternativo. Da specificare per ogni ingresso.
      --cs string               Sovrascrive le impostazioni della configurazione. Usalo una volta per ogni impostazione. Per esempio: --cs "AutoAdvance=1"
      --confighelp              Mostra una lista di impostazioni di configurazione e i loro valori attuali.
      --config file             Usa un altro file di configurazione.

L'opzione `--cs` ti permette di regolare un valore di configurazione che altrimenti sarebbe modificabile solo tramite le finestre di configurazione. Stai però attento, perché quando &kdiff3; viene chiuso con il valore modificato, questa modifica verrà memorizzata con le altre impostazioni. Con `--confighelp` puoi trovare i nomi degli elementi disponibili e i loro valori attuali.

Con `--config` puoi specificare un altro file di configurazione. Quando usi spesso &kdiff3; con configurazioni completamente diverse, questo ti permette di passare facilmente da una all'altra.

#### Opzioni da riga di comando ignorabili

Molte persone vogliono usare &kdiff3; con qualche sistema di controllo di versione. Ma quando quel sistema di controllo di versione chiama &kdiff3; usando parametri della riga di comando che &kdiff3; non riconosce, allora &kdiff3; termina con un errore. Le impostazioni di integrazione permettono di specificare parametri della riga di comando che dovrebbero essere ignorati da &kdiff3;. Essi appariranno nell'aiuto all'uso come in questo esempio:

    --pippo                     Ignorato (definito dall'utente).

Opzioni da riga di comando da ignorare:

  Una lista di opzioni, separate da un punto e virgola, «;». Quando una di queste opzioni appare nella riga di comando, &kdiff3; la ignorerà e verrà eseguito senza riportare errori (le opzioni predefinite sono «u;query;html;abort»).

Se questo non bastasse, si raccomanda di scrivere uno script per la shell per tradurre l'opzione.

### Finestra di apertura dei file

Poiché devono essere selezionabili molti file, il programma ha una particolare finestra per aprirli:

La finestra di apertura ti permette di scrivere il nome del file a mano, di selezionare un file con il navigatore (File...) o di scegliere i file più recenti da una lista a comparsa. Se riapri la finestra, i nomi attuali rimarranno lì. Il nome del terzo file di input non è necessario. Se il campo di «C» rimane vuoto, verrà fatta soltanto un'operazione di confronto tra due file.

Puoi anche selezionare una cartella con Cartella.... Se per A è specificata una cartella sarà automaticamente attivato il confronto o la fusione di cartelle. Se A specifica un file ma B, C o l'uscita specificano una cartella, &kdiff3; usa il nome del file di A nella cartelle specificate.

Se viene selezionato Fondi, allora la riga Uscita diverrà modificabile. Però non è necessario specificare subito il nome del file in uscita: lo potrai specificare in seguito, fino al momento del salvataggio.

Il pulsante Configura... apre una finestra di opzioni, per poterle impostare prima di avviare l'analisi.

### Incolla e trascina l'ingresso

A volte vorresti confrontare parti di testo che non sono un file. &kdiff3; permette anche di incollare del testo dagli appunti nella finestra di confronto selezionata. L'analisi delle differenze apparirà immediatamente. Nella finestra di apertura dei file non dovrai specificare i file, basterà chiuderla con Annulla.

È anche possibile usare il trascinamento: prendi un file dal gestore dei file o seleziona del testo da un editor, e trascinalo dentro una finestra di confronto.

Qual è l'idea? A volte un file contiene due funzioni simili, ma controllare quanto lo sono effettivamente è una seccatura se si devono prima creare due file e quindi caricarli. Ora puoi semplicemente copiare, incollare e confrontare le sezioni rilevanti.

Nota: al momento non puoi trascinare niente da &kdiff3;. Solo l'inserimento nella finestra di confronto delle differenze è supportato.

Attenzione: alcuni editor interpretano il trascinamento in altri programmi come operazioni di taglia (invece che copia) e incolla. In tal caso i dati originali andrebbero quindi persi.

### Confrontare i file e interpretare le informazioni nelle finestre di ingresso

#### Riga informativa

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.

#### Colorazione

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 dal menu 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 (Colore per i conflitti nelle impostazioni). Questo schema di colori è molto utile nel caso di tre file di ingresso, che discuteremo nella prossima sezione (Fusione).

#### Colonna di riepilogo

A sinistra di ogni testo c'è la «colonna di sommario». Se ci sono differenze su una riga, la colonna di sommario ne mostrerà il colore corrispondente. Nel sommario 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 solo in 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.

#### Colonna riassuntiva

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.

#### Allineare manualmente le righe

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 Aggiungi allineamento manuale delle differenze nel menu Vista di confronto (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.

#### Unire e dividere manualmente sezioni di differenze

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 Dividi differenze alla selezione nel menu Fondi. 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 Unisci le differenze selezionate nel menu Fondi.

### Operazione di fusione e la finestra di modifica del risultato

Anche la finestra di modifica del risultato della fusione (sotto la finestra di ingresso) ha una riga informativa sovrastante che mostra l'"Output:", il nome del file e "[Modificato]" se qualcosa è stato variato. Normalmente essa contiene del testo creato dagli automatismi della fusione, ma spesso conterrà anche dei conflitti.

!!! Il salvataggio è disabilitato fino a quando tutti i conflitti non sono risolti !!! (Usa il pulsante "Vai al precedente/prossimo conflitto non risolto" per ricercare i conflitti rimanenti)

Se i file di ingresso sono solo due, ogni differenza è un conflitto che deve essere risolto manualmente.

Con tre file di input il primo è considerato come base, mentre il secondo ed il terzo contengono le modifiche. Quando in qualche riga solo il file B o il file C presenta una differenza, ma non entrambi, allora il file modificato sarà automaticamente selezionato. Solo quando B e C hanno delle differenze sulle stesse righe il programma si accorgerà del conflitto il quale dovrà essere risolto manualmente. Quando B e C coincidono, ma differiscono con A, allora sarà selezionato C.

#### La colonna di sommario

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.

#### Impostare il gruppo attuale e sincronizzare la posizione delle viste di fusione e differenze

Quando si fa clic sulla colonna di sommario con il 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 il "Colore di fondo per questo intervallo attuale" e una barra nera apparirà sul lato sinistro del testo.

#### Scegliere gli input A, B o C per il conflitto attuale e per modificarlo

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», poi su «A».

Se usi l'opzione avanzamento automatico ("Vai automaticamente al prossimo conflitto non risolto dopo la selezione del sorgente"), 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.

#### Scegliere l'input A, B o C per tutti i conflitti

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.

Nota: Quando si sceglie un sorgente per conflitti non risolti di spazi bianchi e quando vengono utilizzate le opzioni "Ignora numeri" o "Ignora commenti C/C++",le variazioni nei numeri o nei commenti saranno trattati anch'essi come spazi bianchi.

#### Fusione automatica della cronologia (log) e delle parole chiave del controllo di versione

Molti sistemi di controllo di versione supportano parole chiave speciali nel file. (es. "$Date$", "$Header$", "$Author$", "$Log$" etc.) 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. Per righe semplici che corrispondono all'opzione "Fondi automaticamente le espressioni regolari" in tutti i file di input &kdiff3; sceglierà la riga dalla B o - se disponibile - dalla 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 il menu di fusione "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 o più tardi con il menu di fusione 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. 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 per raggruppare parti dell'espressione regolare che dovrebbero essere usate in seguito per la chiave di ordinamento. Specifica quindi la 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: consideriamo una cronologia simile 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 i singoli elementi.

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 della Trolltech. Nota che \s (con la minuscola) corrisponde ai caratteri di spaziatura e \S (con la maiuscola) corrisponde a ogni 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 Impostazioni di fusione.

### Navigazione e modifica

È possibile navigare con le barre di scorrimento e con il mouse, ma puoi anche usare i tasti. Se fai clic dentro una delle finestre, potrai usare i pulsanti sinistra, destra, alto, basso, pagina successiva, pagina precedente, inizio, fine, ctrl-inizio, ctrl-fine come faresti in altri programmi. La colonna riassuntiva di fianco alla barra di scorrimento verticale dei file di ingresso può anche essere usata per la navigazione facendoci clic.

È anche possibile usare la rotellina del mouse per scorrere in alto e in basso.

Nella finestra di modifica del risultato puoi anche usare gli altri tasti. Puoi passare tra le modalità di inserimento e di sovrascrittura con il tasto Ins; la predefinita è quella di inserimento.

Fare clic con il &LMB; in una qualsiasi colonna di sommario sincronizzerà tutte le finestre in modo da mostrare l'inizio dello stesso gruppo di righe (come spiegato nella sezione Impostare il gruppo attuale e sincronizzare la posizione delle viste di fusione e differenze.

La barra dei pulsanti contiene inoltre nove pulsanti di navigazione con cui puoi passare alla differenza attuale, alla prima o all'ultima, a quella successiva o precedente (&Ctrl;↓ e &Ctrl;↑), al conflitto successivo o precedente (&Ctrl;Pag↓ e &Ctrl;Pag↑), o al conflitto non risolto successivo o precedente. Nota che per &kdiff3; un conflitto che non è stato risolto automaticamente all'inizio della fusione rimane un conflitto anche se è stato risolto; da qui la necessità di distinguere i conflitti non risolti.

#### Avanzamento automatico

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 nelle impostazioni delle differenze e di fusione: puoi specificare il Ritardo nell'avanzamento automatico 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;1 per selezionare A, B e C nel caso di molti conflitti.

### Selezione, Copia e Incolla

La finestre dell'ingresso non hanno un cursore, quindi le selezioni vanno fatte con il &LMB; partendo dall'inizio, tenendolo premuto e spostandolo fino alla fine della selezione, dove lo rilasci. È possibile selezionare una singola parola facendo doppio clic. Nella finestra del risultato di fusione puoi anche selezionare con la tastiera, tenendo premuto il tasto &Shift; e navigando con i tasti a freccia.

Se la selezione deve andare oltre la parte visibile sullo schermo, puoi spostare il mouse ai bordi della finestra, il che fa scorrere &kdiff3; in quella direzione.

Per selezioni molto grandi, puoi anche usare i tasti di navigazione tenendo premuto il &LMB;. Per esempio, usa Pag↑ e Pag↓ per andare velocemente a un certo punto; a quel punto rilascia il mouse.

Per selezionare tutto nella finestra attuale, usa il menu Modifica Seleziona tutto (&Ctrl;A).

Per copiare negli appunti devi premere il pulsante Copia (&Ctrl;C o &Ctrl;Ins). Esiste anche l'opzione Copia automatica: se è attiva, tutto quello che selezioni verrà copiato immediatamente, senza farlo esplicitamente. Fai però attenzione, perché i contenuti degli appunti potrebbero andare accidentalmente persi.

Taglia (&Ctrl;X o &Shift;Canc copia negli appunti il testo selezionato e lo cancella.

Incolla (&Ctrl;V o &Shift;Ins inserisce il testo dagli appunti alla posizione del cursore o al posto della selezione attuale. Se incolli in una delle finestre di ingresso delle differenze, i contenuti degli appunti saranno mostrati in quella finestra, e il confronto verrà immediatamente riavviato. Ciò è utile se vuoi prendere del testo da qualche parte e confrontarlo con qualcos'altro senza prima dover creare dei file.

### Salvataggio

Il salvataggio sarà permesso solo quando tutti i conflitti saranno stati risolti. Se il file esiste già, e l'opzione Copie di sicurezza è abilitata, il file esistente sarà rinominato con l'estensione `.orig`, ma se quest'ultimo file esiste sarà rimosso. Se concludi o avvii una nuova analisi delle differenze, e i dati non sono stati ancora salvati, &kdiff3; ti chiederà se vuoi salvare, annullare o procedere senza salvare. &kdiff3; non intercetta nessun segnale, quindi se si uccide il processo di &kdiff3; tutti i dati andranno persi.

I caratteri di fine riga sono salvati secondo il metodo appropriato per il sistema operativo in uso. Sui sistemi Unix ogni riga termina con il carattere \n, mentre sui sistemi Windows ogni riga termina con i caratteri di ritorno a capo e di nuova riga, \r\n. &kdiff3; non mantiene i caratteri di fine riga originali del file, il che vuol dire che non dovresti usare &kdiff3; con i file binari.

### Ricerca delle stringhe

Puoi cercare una stringa in ogni finestra di testo di &kdiff3;. Il comando Trova (&Ctrl;F) nel menu Modifica apre una finestra che ti permette di specificare la stringa da cercare. Puoi anche selezionare le finestre nella quali cercare. La ricerca partirà sempre dall'inizio. Usa il comando Trova successivo (F3) per passare alla prossima occorrenza. Se decidi di cercare su più finestre, la ricerca comincerà dalla prima finestra, poi passerà alla seconda, e così via.

### Stampa

&kdiff3; supporta la stampa delle differenze dei file di testo. Il comando Stampa (&Ctrl;P) nel menu File apre una finestra che ti permette di selezionare la stampante e regolare altre opzioni.

Ci sono diverse possibilità per regolare l'intervallo di stampa. Siccome le finestre di stampa sono diverse a seconda del sistema operativo, il modo esatto in cui regolarlo varia.

Tutto:

  Stampa tutto.

Attuale:

  Stampa una pagina partendo dalla prima riga visibile nella finestra. Sui sistemi senza questa opzione, essa è ottenibile chiedendo di stampare il numero di pagina 10000.

Selezione:

  Prima di stampare, seleziona il testo con il mouse (come quando fai copia e incolla) in una delle finestre d'ingresso delle differenze per definire le righe di inizio e fine. Se non è stato selezionato del testo nelle finestre di ingresso delle differenze, questa scelta non sarà disponibile. Sui sistemi senza questa opzione, essa è ottenibile chiedendo di stampare il numero di pagina `9999`.

Intervallo:

  Specifica la prima e l'ultima pagina.

Altre opzioni di stampa importanti saranno dedotte dalle opzioni normali:

- Carattere e sue dimensioni

- Mostra i numeri di riga

- A capo automatico

- Colori

- eccetera

Si raccomanda inoltre di usare il formato orizzontale quando si stampa.

### Opzioni

Le opzioni e l'elenco dei file recenti saranno salvate all'uscita del programma, e ricaricate quando verrà riavviato (Impostazioni Configura &kdiff3; ).

#### Carattere

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

Corsivo per le differenze:

  Selezionando questo, le differenze di testo saranno rappresentate con il carattere scelto in stile corsivo. Se il carattere non supporta il corsivo, l'opzione non avrà effetto.

#### Colori

Colore di primo piano:

  Normalmente nero.

Colore di sfondo:

  Normalmente bianco.

Colore di sfondo per le differenze:

  Normalmente grigio chiaro.

Colore per A:

  Normalmente blu scuro.

Colore per B:

  Normalmente verde scuro.

Colore per C:

  Normalmente magenta scuro.

Colore per i conflitti:

  Normalmente rosso.

Colore di sfondo per l'intervallo attuale:

  Normalmente giallo chiaro.

Colore di sfondo per le differenze dell'intervallo attuale:

  Normalmente giallo scuro.

Colore per intervalli di differenze selezionati manualmente:

  Normalmente arancione.

Colore del file più recente nel confronto tra cartelle:

  Normalmente verde.

Colore del file più vecchio nel confronto tra cartelle:

  Normalmente rosso.

Colore del file di età media nel confronto tra cartelle:

  Normalmente giallo scuro.

Colore per file mancanti nel confronto tra cartelle:

  Normalmente nero.

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.

#### Impostazioni dell'editor

Il tabulatore inserisce spazi:

  Se questo è disabilitato e premi il tasto di tabulazione, verrà inserito un carattere di tabulazione, altrimenti verranno inseriti il numero appropriato di spazi.

Dimensione della tabulazione:

  Può essere regolata a seconda delle necessità. Il valore predefinito è 8.

Rientro automatico:

  Quando premi &Enter;, il rientro della riga precedente sarà usato per la nuova.

Copia automaticamente la selezione:

  Ogni selezione è immediatamente copiata negli appunti quando attiva, e non sarà necessario copiarla esplicitamente.

Tipo di fine riga:

  Quando salvi un file puoi decidere quali caratteri di fine riga usare.L'impostazione predefinita è quella abituale del sistema operativo in uso.

#### Impostazioni delle differenze

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.

Ignora i numeri:

  Come impostazione predefinita questa opzione è disattivata. I caratteri numerici (da 0 a 9, ., -) saranno ignorati nella prima parte dell'analisi nella quale si fanno corrispondere le righe. Nel risultato le differenze saranno comunque mostrate, ma i caratteri numerici saranno trattati come spazi.

Ignora i commenti C e C++:

  Come impostazione predefinita questa opzione è disattivata. Le variazioni dei commenti saranno trattate come variazioni di spazi.

Ignora le maiuscole:

  Come impostazione predefinita questa opzione è disattivata. Le differenze tra maiuscole e minuscole (come tra A e a) saranno trattate come differenze tra spazi.

Comando per il preprocessore

  Vedi la prossima sezione.

Comando del preprocessore per confrontare righe:

  Vedi la prossima sezione.

Ricerca approfondita:

  Ricerca approfondita per ricercare la più piccola differenza (Normalmente attiva). Questo sarà probabilmente utile per file complicati e lunghi. E lento per file molto lunghi.

#### Impostazioni di fusione

Pausa nell'avanzamento automatico (ms):

  Quando l'opzione di auto avanzamento automatico è attiva si specifica quando lungo mostrare il risultato delle selezione prima di saltare al prossimo conflitto non risolto.

Trattamento predefinito degli spazi bianchi nel fondere 2 file:

  Risolvi automaticamente tutti i conflitti di spazi scegliendo il file specifico (l'impostazione predefinita è la scelta manuale). Utile se gli spazi non sono importanti in molti file. Se ti serve solo di rado, è meglio usare Scegli A/B/C per tutti i conflitti di spazi non risolti nel menu di fusione. Nota che, se abiliti Ignora i numeri o Ignora i commenti C e C++, questa scelta automatica verrà applicata anche per i conflitti tra numeri o commenti.

Espressione regolare di fusione automatica:

  Espressione regolare per le righe dove &kdiff3; dovrebbe scegliere automaticamente una sorgente. Vedi anche Fusione automatica.

Esegui la fusione automatica con espressioni regolari all'avvio della fusione:

  Se attivo, &kdiff3; esegue la fusione automatica usando l'Espressione regolare di fusione automatica all'avvio di una fusione.

Espressione regolare dell'inizio di cronologia:

  Espressione regolare per l'inizio di un elemento di cronologia di fusione. Normalmente questa riga contiene la parola chiave `$Log$`. Il valore predefinito è `.*\$Log.*\$.*`.

Espressione regolare di inizio dell'elemento di cronologia:

  Un elemento di cronologia di fusione consiste di diverse righe. Specifica l'espressione regolare per rilevarne la prima (senza il commento iniziale). Usa le parentesi per raggruppare le chiavi che vuoi usare per l'ordinamento. Se lasciato vuoto, &kdiff3; suppone che le righe vuote separino gli elementi di cronologia. Vedi anche Fusione automatica.

Ordinamento della fusione della cronologia:

  Abilita l'ordinamento della cronologia del controllo di versione.

Ordine della chiave d'ordinamento d'inizio degli elementi della cronologia:

  Ogni parentesi usata nell'espressione regolare per l'elemento iniziale della cronologia raccoglie una chiave disponibile per l'ordinamento. Specifica l'elenco di chiavi (numerate in ordine di apparizione partendo da 1) separandole con una virgola (`,`), per esempio `4,5,6,1,2,3,7`. Se lasciato vuoto, non verrà effettuato un riordinamento. Vedi anche Fusione automatica.

Fondi la cronologia del controllo di versione all'inizio della fusione

  Se attivato, &kdiff3; esegue la fusione automatica della cronologia usando le opzioni sunnominate all'avvio di una fusione.

Numero massimo di elementi nella cronologia:

  &kdiff3; tronca l'elenco della cronologia dopo il numero di elementi specificato. Usa `-1` per evitare il troncamento, il che è anche il valore predefinito.

Prova le espressioni regolari

  Questo pulsante mostra una finestra che permette di migliorare e provare le espressioni regolari indicate sopra. Basta copiare i dati dai file nelle righe d'esempio, e il Risultato di corrispondenza mostrerà subito se la corrispondenza avviene o meno. Il Risultato della chiave di ordinamento mostrerà la chiave usata per il riordinamento della fusione della cronologia.

Comando di fusione irrilevante:

  Specifica un comando da chiamare quando &kdiff3; rileva che, per una fusione a tre file, il file B non contribuisce alcun dato di rilievo che non sia già contenuto nel file C. Il comando viene chiamato con tre nomi di file come parametri. I dati corrispondenti alla Espressione regolare di fusione automatica o nella cronologia non sono considerati di rilievo.

#### Fusione di cartelle

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:

Copie di sicurezza:

  Quando viene salvato un file e ne esiste una versione precedente, la versione originale sarà rinominata con un'estensione `.orig`. Se esiste già una vecchia copia di sicurezza con estensione `.orig`, questa verrà eliminata senza farne un'altra copia.

#### Lingua e paese

Lingua:

  Imposta la lingua usata per l'interfaccia utente. Le modifiche a questa opzione non hanno effetto immediato sul programma. Devi chiudere &kdiff3; e riavviarlo per far cambiare la lingua. Questa opzione non è disponibile nella versione Frameworks di &kdiff3;.

Usa la stessa codifica per tutto:

  Le opzioni di codifica che seguono possono essere fissate separatamente per ogni voce o, se questa opzione è attivata, il primo valore vale per tutti.

Codifica locale:

  Davanti ai selettori di codifica appare una nota che ti dice qual è la codifica locale. Non è modificabile, serve solo a ricordarti la codifica locale nel caso che tu non lo sapessi già, ma avessi bisogno di selezionarla.

Codifica per i file A/B/C:

  Cambia la codifica dei file in ingresso. Ha effetto sulla visualizzazione dei caratteri speciali. Poiché puoi aggiustare separatamente le codifiche, potrai confrontare e fondere file prodotti con codifiche diverse.

Codifica per i file fusione e salvataggio:

  Quando avrai modificato un file, potrai scegliere con quale codifica salvarlo sul disco fisso.

Codifica per i file sottoposti al preprocessore:

  Quando definisci un preprocessore questo deve essere in grado di operare sulla codifica in uso (ad esempio, i tuoi file sono Unicode a 16 bit e il tuo preprocessore può operare solo su file &ASCII; a 8 bit). Con questa opzione puoi definire la codifica del risultato del preprocessore.

Lingue scritte da destra a sinistra:

  Alcune lingue sono scritte sa destra a sinistra. Quando questa opzione è attivata, &kdiff3; scrive il testo da destra a sinistra nelle finestre di ingresso delle differenze e nella finestra di uscita della fusione. Nota che se avvii &kdiff3; dalla riga di comando con l'opzione `--reverse`, anche tutta l'interfaccia grafica sarà impostata da destra a sinistra (è una funzionalità fornita da &Qt;). Questa documentazione è stata scritta assumendo che l'opzione Lingue scritte da destra a sinistra e l'impostazione grafica inversa non siano state attivate. Quindi alcune occorrenze di destra e sinistra dovranno essere scambiate nel caso si usi questa possibilità.

#### Varie

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

Mostra i numeri di riga:

  Puoi selezionare se, per il file di ingresso, il numero di riga deve essere visualizzato.

Mostra anche le differenze date da spazi e tabulatori:

  Alcune volte la visualizzazione degli spazi e dei tabulatori disturba. È possibile eliminarla.

Mostra spazio bianco:

  Disabilitalo per sopprimere l'evidenziazione delle modifiche di soli spazi nel testo o nelle colonne riassuntive. Nota che vale anche per le modifiche dei numeri o dei commenti se sono attive le opzioni Ignora i numeri o Ignora i commenti C e C++.

Opzioni delle colonne riassuntive:

  Queste opzioni sono disponibili solo quando si confrontano tre file. Nella modalità normale tutte le differenze vengono mostrate in una sola colonna riassuntiva codificata con dei colori. Però, a volte, potrebbe interessarti evidenziare solo le differenze tra due dei tre file. Selezionare Riassunto tra A e B, Riassunto tra A e C, o Riassunto tra B e C aprirà una seconda colonna riassuntiva di fianco a quella normale con le informazioni richieste.

A capo nelle finestre delle differenze:

  Le righe più lunghe della larghezza della finestra vengono mostrate su più righe.

Mostra finestra A, B o C:

  Alle volte vuoi usare meglio lo spazio sullo schermo per le righe lunghe. Nascondi le finestre non importanti (nel menu Finestra).

Inverti orientamento divisione:

  Passa tra mostrare le finestre delle differenze una di fianco all'altra (A a sinistra di B, che a sua volta è a sinistra di C) o una sopra l'altra (A sopra B, a sua volta sopra C). Questo potrebbe essere utile nel caso di righe lunghe (nel menu Finestra).

Avviare velocemente una fusione:

  A volte guardi le differenze e decidi di fondere. Fondi il file attuale nel menu Cartella funziona anche confrontando solo due file. Basta un clic per avviare la fusione, che usa il nome dell'ultimo file di ingresso come predefinito. Quando si usa per riavviare una fusione, il nome del file di uscita sarà mantenuto.

#### Configurazione delle scorciatoie da tastiera

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

### Comandi per il preprocessore

&kdiff3; supporta due opzioni del preprocessore.

Comando per il preprocessore

  Quando un file viene letto viene incanalato come ingresso a questo comando esterno. Verrà visualizzato il risultato del comando invece del file iniziale. Puoi scrivere il tuo preprocessore secondo le tue esigenze specifiche. Usalo per esempio per tagliare parti di file che danno fastidio, per correggere automaticamente il rientro, eccetera.

Comando del preprocessore per confrontare righe:

  Quando un file viene letto, esso viene trattato da questo comando esterno. Se viene specificato un comando come preprocessore (vedi sopra), allora l'uscita dal preprocessore è anche l'ingresso del preprocessore che confronta le righe. Il risultato sarà usato durante la fase di analisi delle righe coincidenti. Puoi scrivere un tuo preprocessore personalizzato che risolva le tue esigenze. Ogni riga in ingresso deve avere una riga corrispondente in uscita.

L'idea è quella di permettere la maggior flessibilità possibile nell'impostare il risultato del confronto. Purtroppo ciò richiede l'uso di un programma esterno, e molti utenti non hanno voglia di scriversene uno. La buona notizia è che molto spesso `sed` o `perl` sono perfettamente in grado di svolgere il lavoro richiesto.

Un semplice esempio con un file di testo: prendi il file a.txt (6 righe):

          aa
          ba
          ca
          da
          ea
          fa

e il file b.txt (3 righe):

          cg
          dg
          eg

Senza un preprocessore appariranno le seguenti righe affiancate:

          aa - cg
          ba - dg
          ca - eg
          da
          ea
          fa

Probabilmente non era quello che desideravi, poiché la prima lettera contiene l'informazione realmente interessante. Per aiutare l'algoritmo di confronto ad ignorare la seconda lettera potremmo usare come preprocessore un comando che rimpiazzi riga per riga "g" con "a":

       sed 's/g/a/'

Con questo comando il risultato del confronto sarà:

          aa
          ba
          ca - cg
          da - dg
          ea - eg
          fa

Internamente l'algoritmo di confronto usa i file elaborati riga per riga dal preprocessore, ma sullo schermo il file non appare modificato. Un preprocessore normale avrebbe cambiato anche i dati visualizzati.

#### Concetti di base del `sed`

Questa sezione spiega sommariamente alcune funzionalità elementari di `sed`. Per maggiori informazioni vedi info:/sed o http://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 paragrafo userò solo il comando di sostituzione `sed`:

       sed 's/ESPREG/NUOVO_TESTO/CODICE'

Prima di usare un nuovo comando in &kdiff3; sarebbe meglio provarlo in una console. Per farlo è utile il comando `echo`. Ad esempio:

       echo abracadabra | sed 's/a/o/'
       obracadabra

Questo esempio mostra un semplicissimo comando sed che sostituisce la prima occorrenza di `a` con `o`. Volendo sostituire tutte le occorrenze, basta aggiungere il codice `g`:

       echo abracadabra | sed 's/a/o/g'
       obrocodobro

Il simbolo `|` è il comando di incanalamento, che invia il risultato del comando precedente all'ingresso del comando successivo. Se vuoi fare una prova su un file abbastanza lungo, puoi usare `cat` sui sistemi simili a Unix, o `type` sui sistemi di tipo Windows. `sed` farà una sostituzione riga per riga.

    cat nome_file | sed opzioni

#### Esempi per l'uso di `sed` in &kdiff3;

##### Ignorare altri tipi commenti

Attualmente &kdiff3; riconosce solo i commenti C e C++. Usando il comando di preprocesso per il confronto delle righe puoi ignorare altri tipi di commenti, convertendoli in commenti di tipo C o C++. Per esempio, per ignorare i commenti che iniziano per `#`, potresti convertirli in `//`. Tieni presente che devi anche attivare l'opzione Ignora i commenti C e C++ per far funzionare il trucco. Un comando di preprocesso delle righe appropriato potrebbe essere:

       sed 's/#/\/\//'

Poiché per `sed` il carattere `/` ha un significato speciale, è necessario porre un carattere `\` prima di ogni `/` nella stringa del nuovo testo. Spesso il carattere `\` è richiesto per aggiungere o togliere un significato speciale a certi caratteri. Le virgolette semplici (') sono importanti solo quando si eseguono test nella shell dei comandi, dato che in caso contrario tenterà di elaborare alcuni caratteri. KDiff3 non fa questo, eccetto che per le sequenze di escape '\"' e '\\'.

##### Differenze senza distinzione delle maiuscole

Usa questo comando di preprocesso delle righe per convertire tutto in maiuscolo:

       sed 's/\(.*\)/\U\1/'

`.*` è un'espressione regolare corrispondente a qualsiasi stringa, e, in questo caso, a tutti i caratteri della riga. Il `\1` nella stringa di sostituzione rappresenta il testo trovato nel contenuto della prima coppia di parentesi tonde. La `\U` converte in maiuscolo il testo inserito.

##### Ignorare le parole chiave del controllo di versione

CVS ed altri sistemi per il controllo di versione usano molte parole chiave per inserire stringhe generate automaticamente (vedi la pagina Info di CVS). Tutte queste seguono lo schema `$KEYWORD testo generato$`. A questo punto serve un comando di preprocessore che rimuova solo il testo generato:

       sed 's/\$\(Revision\|Author\|Log\|Header\|Date\).*\$/\$\1\$/'

I `\|` separano le possibili parole chiave. Puoi modificare questa lista secondo le tue esigenze. Il `\` prima di `$` è necessario, altrimenti `$` corrisponderebbe alla fine della riga.

Nel provare `sed` potrai incominciare a capire ed apprezzare queste strane espressioni regolari. Sono molto utili perché ci sono molti altri programmi che supportano cose molto simili.

##### Ignorare i numeri

Per ignorare i numeri, in realtà, c'è un'opzione interna. Però, come ulteriore esempio, ecco come apparirebbe come comando di preprocessore per trovare una riga corrispondente.

       sed 's/[0123456789.-]//g'

Ogni carattere compreso tra le parentesi quadre verrà riconosciuto e rimosso (sostituito con nulla).

##### Ignorare alcune colonne

A volte un testo è formattato molto rigorosamente, e contiene delle colonne da ignorare sempre, mentre ci sono altre colonne da tenere e analizzare. Nell'esempio seguente, le prime cinque colonne (cioè caratteri) verranno ignorate, le dieci successive vengono salvate, ne vengono ignorate altre cinque, il resto della riga viene tenuto.

       sed 's/.....\(..........\).....\(.*\)/\1\2/'

Ogni punto `.` corrisponde a un qualsiasi carattere singolo. `\1` e `\2` nella stringa di sostituzione si riferiscono al contenuto della prima e seconda coppia di parentesi tonde, indicanti il testo da tenere.

##### Combinare più sostituzioni

A volte, potresti voler applicare più sostituzioni in una volta. In tal caso si può usare un punto e virgola `;` per separarle l'una dall'altra. Ad esempio:

    echo abracadabra | sed 's/a/o/g;s/\(.*\)/\U\1/'
       OBROCODOBRO

##### Usare `perl` invece di `sed`

Invece di `sed` potresti voler utilizzare un altro comando, ad esempio `perl`.

       perl -p -e 's/ESPREG/NUOVO_TESTO/CODICE'

Alcuni dettagli sono però diversi in `perl`. Nota che mentre `sed` vuole le parentesi tonde come `\(` e `\)`, in `perl` servono le più semplici `(` e `)`, senza farle precedere da `\`. Per esempio:

       sed 's/\(.*\)/\U\1/'
       perl -p -e 's/(.*)/\U\1/'

#### Ordine di esecuzione del preprocessore

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

- Preprocessore normale,

- Preprocessore di confronto delle righe,

- Ignora le lettere maiuscole (conversione in maiuscolo),

- Rilevamento dei commenti C e C++:

- Ignorare i numeri,

- Ignora gli spazi

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.

#### Attenzione

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 è attivo un comando del preprocessore sul contenuto delle righe. La fusione non sarà completata finché non saranno risolti tutti i conflitti. Se hai disabilitato Mostra spazi, anche le differenze che rimosse con il preprocessore sul contenuto delle righe saranno invisibili. Se il pulsante di salvataggio rimane disattivato durante una fusione (perché sussistono dei conflitti), assicurati di attivare Mostra spazi. Se non vuoi fondere manualmente queste differenze meno importanti, puoi selezionare Scegli [A|B|C] per tutti i conflitti di spazi non risolti nel menu di fusione.

## Confronto e fusione di cartelle con &kdiff3;

### Introduzione al confronto e alla fusione tra cartelle

Spesso i programmatori devono modificare molti file in una cartella per realizzare i loro scopi. Per questo &kdiff3; permette anche di confrontare e fondere ricorsivamente intere cartelle.

Anche se confrontare e fondere delle cartelle sembra abbastanza semplice, ci sono diversi dettagli da considerare. Il più importante è ovviamente che ora molti file potrebbero essere coinvolti in ogni operazione. Se non hai copie di sicurezza dei dati originali, può essere molto difficile se non impossibile tornare allo stato originale. Quindi, prima di avviare una fusione, assicurati che i tuoi dati siano al sicuro e che sia possibile tornare indietro. È una tua decisione se archiviarli o se usare un sistema di controllo delle versioni, ma anche i programmatori esperti hanno bisogno dei vecchi sorgenti ogni tanto. Nota che anche se io (l'autore di &kdiff3;) cerco di fare del mio meglio, non posso garantire che non ci siano errori. In accordo con la licenza GNU GPL, non c'è alcuna garanzia per questo programma. Quindi attenzione e ricordate:

> Errare è umano, ma per fare un gran casino è necessario un computer.

Ecco quindi quello che questo programma può fare per te: &kdiff3;...

- ... legge e confronta due o tre cartelle ricorsivamente,

- ... fa particolare attenzione ai collegamenti simbolici,

- ... permette di sfogliare i file con un doppio clic del mouse,

- ... per ogni elemento propone un'operazione di fusione, che puoi cambiare prima di avviare la fusione delle cartelle,

- ... permette di simulare la fusione ed elenca le azioni che verrebbero fatte, senza eseguirle per davvero,

- ... permette di fondere, e permette l'intervento manuale quando questo è necessario,

- ... ti permette di avviare l'operazione selezionata per tutti gli elementi (tasto F7) o per l'elemento selezionato (tasto F6),

- ... permette di continuare la fusione dopo l'interazione manuale con il tasto F7,

- ... a scelta, crea delle copie di sicurezza, con l'estensione `.orig`,

- ...

### Avviare il confronto o la fusione di cartelle

Questa operazione è molto simile al confronto e alla fusione di un file. È necessario specificare le cartelle nella riga di comando o nel dialogo di selezione dei file.

#### Confronta o fondi due cartelle:

    kdiff3 cartella1 cartella2
    kdiff3 cartella1 cartella2 -o cartella_destinazione

Se non viene specificata una cartella di destinazione, &kdiff3; userà cartella2.

#### Confronta o fondi tre cartelle:

    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 nessuna 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).

### Informazioni visibili sulla fusione delle cartelle

Durante la lettura delle cartelle appare un messaggio per notificare lo stato di avanzamento. Se annulli la scansione delle cartelle, saranno elencati solo i file che sono stati confrontati fino a quel momento.

Quando la scansione delle cartelle è completata, &kdiff3; mostra un elenco dei risultati a sinistra, ...

... e i dettagli dell'elemento attualmente selezionato a destra:

#### La colonna del nome

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 freccia sinistra o destra. Il menu Cartella contiene inoltre due azioni, Chiudi sottocartelle e Apri 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:

- File normale

- Cartella normale (immagine di una cartella)

- Collegamento a un file (immagine di un file con una freccia)

- Collegamento a una cartella (immagine di una cartella con una freccia)

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.

#### Le colonne A, B e C e lo schema di colorazione

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

- Nero: questo elemento non esiste in questa cartella.

- Verde: elemento più recente.

- Giallo: più vecchio del verde, più recente del rosso.

- Rosso: elemento più vecchio.

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 da dirdiff. I colori sembrano i colori di una foglia, che è verde quando è nuova, successivamente ingiallisce e diventa rossa quando è vecchia.

#### La colonna Operazione

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 e Cancella, 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:

- Fusione di tre cartelle (A è considerato la base più vecchia di entrambe).

- Fusione di due cartelle.

- Modalità di sincronizzazione di due cartelle (attivabile con l'opzione Sincronizza cartelle).

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

- … le tre cartelle sono uguali: copia da C

- … A e C sono uguali ma B no: copia da B, o elimina la destinazione se B non esiste

- … A e B sono uguali ma C no: copia da C, o elimina la destinazione se C non esiste

- … B e C sono uguali ma A no: copia da C, o elimina la destinazione se C non esiste

- … esiste solo A: elimina la destinazione, se esiste

- … esiste solo B: copia da B

- … esiste solo C: copia da C

- … A, B e C non sono uguali: fondi

- … A, B e C non sono dello stesso tipo (per esempio A è una cartella e B è un file): Errore: tipi di file in conflitto. La fusione non può essere avviata finché esistono questi elementi.

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

- … entrambe le cartelle sono uguali: copia da B

- … A esiste, ma B no: copia da A

- … B esiste, ma A no: copia da B

- … A e B esistono ma non sono uguali: fondi

- … A e B non sono dello stesso tipo (per esempio A è una cartella, B è un file): Errore: tipi di file in conflitto. La fusione non può essere avviata finché esistono questi elementi.

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…

- … entrambe le cartelle sono uguali: non sarà fatto nulla

- … A esiste, ma B no: copia A su B

- … B esiste, ma A: copia B su A

- … A e B esistono, ma non sono uguali: fondi e memorizza il risultato in entrambe le cartelle. Il nome del file di salvataggio visibile all'utente è quello di B, ma &kdiff3; copia B anche su A.

- … A e B non sono dello stesso tipo (per esempio A è una cartella, B è un file): Errore: tipi di file in conflitto. La fusione non può essere avviata finché esistono questi elementi.

Quando due cartelle vengono fuse ed è selezionata l'opzione Copia il più recente invece di fondere, &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.

#### La colonna Stato

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.

#### Le colonne delle statistiche

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 dei risolti verrà mostrata solo quando si confrontano o fondono tre cartelle.

#### Selezionare i file elencati

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

- Mostra file identici: i file che sono stati verificati essere identici in tutte le cartelle di ingresso.

- Mostra file diversi: file che esistono in due o più cartelle e che non sono uguali.

- Mostra file solo in A: file che esistono in A, ma non in B o C.

- Mostra file solo in B: file che esistono in B, ma non in A o C.

- Mostra file solo in C: file che esistono in C, ma non in A o B.

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;.

### Fondere le cartelle

Puoi o fondere l'elemento attualmente selezionato (file o cartella), o tutti gli elementi. Quando hai scelto tutte le tue operazioni (anche in tutte le sottocartelle) puoi avviare la fusione.

Attenzione che se non specifichi esplicitamente una cartella di destinazione, questa sarà C nella modalità con tre cartelle, B nella modalità con due, e nella modalità di sincronizzazione sarà A o B.

Se è stata specificata la cartella di destinazione, va verificato anche che tutti gli elementi di uscita siano nell'albero. Ci sono alcune opzioni che fanno omettere certi elementi dal confronto e dalla fusione delle cartelle. Verifica queste opzioni per non avere delle brutte sorprese:

- Cartelle ricorsive: se disabilitato, gli elementi nelle sottocartelle non saranno trovati.

- Schemi di file e Schemi di file da escludere: include o esclude gli elementi corrispondenti

- Escludi file nascosti

- Opzioni di visualizzazione

Se cambi le impostazioni per elencare più file, devi riesaminare la cartella con Cartella Riesamina; questo perché &kdiff3; non confronta i file esclusi con questi criteri per accelerare il confronto. Se hai cambiato gli schemi per file o cartelle per escludere dei file, la lista dei file sarà aggiornata subito dopo la chiusura della finestra delle opzioni.

Nota che, quando scrivi in una cartella completamente nuova, di solito vuoi copiare anche i file identici. In tal caso abilita l'opzione Mostra file identici. Se la cartella di destinazione è uno degli ingressi, questo non è necessario perché il file è già lì.

Se fin qui sei soddisfatto, il resto è facile.

Per fondere tutti gli elementi: seleziona Cartella Avvia o continua fusione tra cartelle o premi il tasto F7, che ne è la scorciatoia predefinita. Per fondere solo l'elemento attuale, seleziona Esegui operazione sull'elemento attuale o premi F6.

Se esistono ancora elementi con operazioni non valide a causa di tipi di file in conflitto, apparirà una finestrella per indicarli e poter selezionare un'operazione valida.

Se fondi tutti gli elementi, apparirà una finestra con le opzioni Procedi, Simula e Annulla.

- Seleziona Simula se vuoi vedere cosa verrebbe fatto senza farlo per davvero. Verrà mostrato un elenco dettagliato di tutte le operazioni.

- Altrimenti, seleziona Procedi per avviare la fusione vera e propria.

&kdiff3; avvierà quindi l'operazione specifica per tutti gli elementi. Se si richiede un'interazione manuale (fusione di un singolo file), sarà aperta la finestra di fusione (vedi la schermata grande).

Quando hai finito con la fusione manuale di un file, riseleziona Avvia o continua fusione tra cartelle o il tasto F7. Se non hai ancora salvato, una finestra te lo chiederà. &kdiff3; procederà quindi al prossimo elemento.

Quando &kdiff3; incontra un errore, lo segnalerà e mostrerà le informazioni di stato in dettaglio. In fondo a questo elenco ci saranno alcuni messaggi d'errore che dovrebbero aiutare a capire la causa del problema. Quando si fa riprendere la fusione (tasto F7), &kdiff3; darà la scelta tra riprovare o saltare l'elemento che ha causato il problema. Ciò significa che prima di continuare puoi scegliere un'altra operazione, o risolvere il problema in altro modo.

&kdiff3; mostrerà infine una finestrella al completamento della fusione.

Se alcuni elementi sono stati fusi individualmente prima di eseguire la fusione tra cartelle, &kdiff3; lo ricorderà per tutta la sessione di fusione, e non li fonderà di nuovo quando la fusione di tutti gli altri elementi verrà eseguita più tardi. Questi elementi sono considerati completati anche quando la fusione viene saltata o non viene salvato nulla. Solo quando cambi l'operazione di fusione lo stato di completamento dell'elemento sarà rimosso, e l'elemento sarà fuso di nuovo.

### Opzioni per il confronto e la fusione tra cartelle

Le preferenze di &kdiff3; (Impostazioni Configura &kdiff3;) ha una sezione chiamata Fusione tra cartelle con queste opzioni:

Cartelle ricorsive:

  Seleziona se cercare ricorsivamente nelle cartelle.

Schemi di file:

  Solo i file che corrispondono ad uno schema saranno inseriti nell'albero. È possibile specificare più di uno schema usando il punto e virgola (;) come separatore. I caratteri jolly possibili sono * e ?; per esempio `*.cpp;*.h`. Il valore predefinito è `*`. Questi schemi non vengono usati per le cartelle.

Schemi di file da escludere:

  I file che corrispondono a questi schemi saranno esclusi dall'albero. È possibile specificare più di uno schema usando il punto e virgola (;) come separatore. I caratteri jolly possibili sono * e ?. Il valore predefinito è `*.orig;*.o;*.obj`.

Schemi di cartelle da escludere:

  Le cartelle che corrispondono a questi schemi saranno escluse dall'albero. È possibile specificare più di uno schema usando il punto e virgola (;) come separatore. I caratteri jolly possibili sono * e ?. Il valore predefinito è `CVS;deps;.svn`.

Usa .cvsignore:

  Ignora i file e le cartelle che verrebbero ignorati anche da CVS. Molti file generati automaticamente vengono ignorati da CVS. Il vantaggio principale è che questo può cambiare per ogni cartella, secondo il file locale `.cvsignore`. Vedi la pagina Info di .cvsignore.

Trova file e cartelle nascosti:

  Su alcuni filesystem esiste l'attributo nascosto per i file. Su altri un nome del file che comincia con un punto (`.`) lo rende nascosto. Questa opzione permette di decidere se includere questi file nell'albero oppure no. Come impostazione predefinita è attivato.

Segui i collegamenti dei file:

  Per i collegamenti a file: quando disabilitato, vengono confrontati i collegamenti simbolici. Quando abilitato, vengono confrontati i file collegati. Come impostazione predefinita è disattivato.

Segui i collegamenti delle cartelle:

  Per collegamenti a cartelle: quando disabilitato, vengono confrontati i collegamenti simbolici. Quando attivato, i collegamenti saranno trattati come una cartella e saranno scansionati ricorsivamente. Nota che il programma non verifica se il collegamento è ricorsivo. Quindi, per esempio, se una cartella contenente un collegamento ad un'altra causa un ciclo infinito, dopo un po' ciò causerà un esaurimento della memoria e manderà il programma in crash. Come impostazione predefinita è disattivato.

Confronto di nomi di file con distinzione delle maiuscole:

  Il valore predefinito è falso su Windows, vero per gli altri sistemi operativi.

Modalità di confronto dei file:

  Confronto binario:

    Questa è la modalità di confronto predefinita.

  Analisi completa:

    Opera un analisi approfondita di ogni file e mostra le colonne con le informazioni statistiche (numero di conflitti non risolti, risolti, relativi a spazi non bianchi e relativi a spazi bianchi). L'analisi completa è più lenta di una semplice analisi binaria, e ancora più lenta se applicata a file non di testo (indica gli schemi di file da escludere appropriati).

  Fidati della data di modifica:

    Se si confrontano cartelle grandi in una rete lenta, potrebbe essere più veloce confrontare solamente le date di modifica e la dimensione dei file. Ma questo aumento di velocità ha il prezzo di una piccola incertezza. Usa questa opzione con cautela. Come impostazione predefinita è disattivata.

  Fidati della dimensione:

    Simile a fidarsi delle date di modifica. Non c'è un vero confronto. Due file sono considerati uguali se la loro dimensione risulta uguale. Questo è utile quando l'operazione di copia file non ha mantenuto la data di modifica. Usa questa opzione con cautela. Come impostazione predefinita è disattivata.

Sincronizza le cartelle:

  Attiva la modalità di sincronizzazione quando vengono confrontate due cartelle e non è stata indicata una cartella di destinazione. In questa modalità le operazioni proposte saranno scelte in modo che entrambe le cartelle sorgenti siano in seguito uguali. Anche il risultato di fusione sarà scritto in entrambe le cartelle. Come impostazione predefinita è disattivato.

Copia il più recente invece di fondere:

  Invece di fondere, l'operazione proposta copierà il sorgente più recente se ci sono state modifiche; è potenzialmente pericoloso, perché si assume che l'altro file non sia stato modificato: controlla per assicurartene ogni volta. Come impostazione predefinita è disattivato.

Copie di sicurezza:

  Se un file o un'intera cartella è sostituito con un altro o viene eliminato, la versione originale sarà rinominata con l'estensione `.orig`. Se esiste già una copia precedente con estensione `.orig`, sarà eliminata senza farne una copia. Inoltre, ciò ha effetto sulla comune fusione tra singoli file, non solo sulla fusione tra cartelle. Come impostazione predefinita è attivato.

### Altre funzioni nella finestra di fusione tra cartelle

#### Modalità a schermo intero o diviso

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'opzione Vista separata nel menu Cartella. Potrai quindi usare Inverti vista nel menu Cartella per passare tra l'elenco di file e la vista delle differenze, che quindi occuperà tutto lo schermo.

#### Confrontare o fondere un file singolo

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 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 al se viene effettuata una nuova scansione delle cartelle con Cartella Riesamina.

#### Confrontare o fondere file con nomi diversi

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 Confronta file selezionati esplicitamente o Fondi file selezionati esplicitamente dal menu Cartella. 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.

## Argomenti vari

### Trasparenza di rete con KIO

#### Gli slave KIO

La libreria KIO di Frameworks supporta la trasparenza di rete tramite gli slave KIO. &kdiff3; li usa per leggere i file in ingresso e per esaminare le cartelle. Ciò significa che è possibile specificare file e cartelle locali o remoti con un URL.

Esempio:

    kdiff3 prova.cpp ftp://ftp.tantolontano.it/prova.cpp
    kdiff3 tar:/home/pincopallino/archivio.tar.gz/cartella ./dir

La prima riga confronta un file locale con un file su un server FTP. La seconda riga confronta una cartella contenuta in un archivio compresso con una locale.

Altri slave KIO interessanti sono:

- File dal Web (`http:`),

- File da FTP (`ftp:`),

- Trasferimento di file cifrato (`fish:`, `sftp:`),

- Partizioni condivise di Windows (`smb:`),

- File locali (`file:`),

Altre cose possibili, ma probabilmente meno utili sono:

- Pagine Man (`man:`),

- Pagine Info (`info:`),

#### Come scrivere gli URL

Un URL ha una sintassi diversa rispetto ai percorsi dei file delle cartelle locali. Si dovrebbero considerare alcune cose:

- Un percorso può essere relativo e può contenere `.` o `..`. Quando non è possibile per gli URL, che sono sempre assoluti.

- I caratteri speciali devono essere scritti con i caratteri di escape (`#` diventa `%23`, gli spazi diventano `%20`, eccetera). Per esempio un file chiamato `#pippo#` dovrebbe avere l'URL `file:/%23pippo%23`.

- Quando gli URL non funzionano come ci si aspetta, prova ad aprirli con Konqueror e vedere cosa succede.

#### Funzionalità degli slave KIO

La trasparenza di rete ha uno svantaggio: non tutte le risorse hanno le stesse funzionalità.

A volte ciò è dovuto al filesystem del server, altre volte al protocollo. Ecco un breve elenco di limitazioni:

- A volte manca il supporto per i collegamenti.

- O non c'è modo di distinguere se il collegamento punti ad un file o ad una cartella; si assume sempre un file (`ftp:`, `sftp:`).

- Non si può sempre sapere la dimensione del file.

- Supporto limitato per i permessi.

- Manca la possibilità di cambiare i permessi o la data di modifica, quindi i permessi e la data di modifica di una copia saranno diversi dall'originale (vedi l'opzione Fidati della dimensione). Queste operazioni sono permesse solo per i file locali.

### Usare &kdiff3; come un componente KPart

&kdiff3; è un componente KPart. Attualmente implementa l'interfaccia `KParts::ReadOnlyPart`.

Il suo impiego principale è come visore di differenze in KDevelop. KDevelop fa sempre partire prima il visore delle differenze interno. Per richiamare &kdiff3; premi il &RMB; nella finestra del visore e seleziona Mostra in KDiff3Part dal menu contestuale.

&kdiff3; richiede normalmente due file completi in ingresso. Quando viene usato come componente, &kdiff3; presupporrà che il file di ingresso sia una patch nel formato unificato. &kdiff3; recupererà i nome originali dei file dalla patch. Deve essere disponibile almeno uno dei due file. &kdiff3; chiamerà quindi `patch` per ricreare il secondo file.

In &dolphin; puoi selezionare una patch e selezionare dal menu contestuale Anteprima in KDiff3Part. Nota che questa opzione non funzionerà se nessuno dei file originali è disponibile, e non è affidabile se i file originali sono stati modificati prima della generazione della patch.

Quando avviato come componente, &kdiff3; include solo la differenza tra due file, e una barra degli strumenti e un menu ridotti. La fusione o il confronto tra cartelle non sono supportati.

### Usare &kdiff3; come strumento Diff e Merge di Git

&kdiff3; può essere utilizzato come strumento diff e merge di Git.

Basta che aggiungi le righe seguenti al tuo file `gitconfig`.

    [diff]
            tool = kdiff3
    [difftool "kdiff3"]
            path = <percorso all'eseguibile kdiff3 nel tuo sistema>
    [difftool]
            prompt = false
            keepBackup = false
            trustExitCode = false
    [merge]
            tool = kdiff3
    [mergetool]
            prompt = false
            keepBackup = false
            keepTemporaries = false
    [mergetool "kdiff3"]
            path = <percorso all'eseguibile kdiff3 nel tuo sistema
    >

Poi per osservare la differenza tra i due commit usa `git difftool first_hash second_hash --tool=kdiff3 --cc qualche_file_nel_git_tree`

Per eseguire la fusione di un ramo con &kdiff3; usa `git merge nome_ramo && git mergetool --tool=kdiff3`

Dopo aver risolto i conflitti di fusione nel solito modo, è sufficiente eseguire il commit delle modifiche per finire il lavoro.

## Domande e risposte

&reporting.bugs; &updating.documentation;

Perché si chiama &kdiff3;?

Gli strumenti KDiff e KDiff2 (ora &kompare;) esistono già. Inoltre KDiff3 dovrebbe suggerire che può fondere come il programma diff3 presente nella raccolta degli strumenti diff.

Perché l'ho rilasciato con la GPL?

Ho usato a lungo programmi GPL e ho imparato molto guardando il codice sorgente. Così questo è il mio Grazie a tutti i programmatori che a loro volta hanno fatto o faranno lo stesso.

Mancano alcuni pulsanti e funzioni. Cosa c'è che non va?

Hai compilato da sorgente, ma probabilmente non hai specificato correttamente il prefisso per l'installazione. Come impostazione predefinita cmake vuole installare in /usr/local, ma in questo modo non è possibile trovare il file delle risorse dell'interfaccia utente (ossia kdiff3ui.rc). Il file README contiene maggiori informazioni su quale sia il prefisso giusto.

Spesso le righe simili ma non uguali appaiono fianco a fianco, ma a volte no. Perché?

Le righe che presentano differenze di soli spazi sono inizialmente trattate come uguali, mentre una sola differenza non di spazi le rendono diverse. Che righe simili appaiano fianco a fianco è una coincidenza, ma questo fortunatamente è spesso il caso. Vedi anche l'aiuto per le differenze manuali.

Perché tutti i conflitti devono essere risolti prima di poter salvare il risultato della fusione?

Per ogni sezione uguale o diversa, l'editor nella finestra del risultato di fusione ricorda l'inizio e la fine. Questo è necessario per poter risolvere i conflitti manualmente semplicemente selezionando il pulsante del sorgente (A, B o C). Queste informazioni andranno perse in seguito al salvataggio del testo, perché è troppo oneroso creare un formato di file che supporti il salvataggio e il ripristino di tutte le informazioni necessarie.

Come posso sincronizzare le viste di differenze e fusioni, in modo che tutte le viste mostrino la stessa posizione del testo?

Fai clic nella colonna di sommario a sinistra del testo (vedi anche qui).

Perché l'editor nella finestra del risultato di fusione non ha una funzione di annullamento?

Questa funzione richiedeva troppo sforzo. È sempre possibile ripristinare una versione da una sorgente (A, B o C) facendo clic il rispettivo pulsante. Per modifiche maggiori si raccomanda comunque l'uso di un altro editor.

Quando ho rimosso del testo mi è apparso improvvisamente «<Riga sorgente mancante>», e non può essere eliminato. Cosa significa e come si può rimuovere?

L'editor nella finestra del risultato della fusione ricorda dove inizia e dove finisce ogni sezione diversa o uguale. «<Riga sorgente mancante>» significa che in una sezione non c'è più nulla, nemmeno un carattere di ritorno a capo. Questo può capitare sia nella fusione automatica che modificando il file a mano. Questo non è un problema, perché questa indicazione non apparirà nel file salvato. Se rivuoi il file originale basta selezionare la sezione (fai clic sulla colonna di sommario a sinistra) e fai quindi clic sul pulsante del sorgente con il contenuto voluto (A/B or C).

Perché &kdiff3; non supporta l'evidenziazione della sintassi?

&kdiff3; già usa molti colori per l'evidenziazione delle differenze. Altre evidenziazioni farebbero confusione. Per questi scopi usa un altro editor.

Posso usare &kdiff3; per confrontare file di OpenOffice.Org, Word, Excel, PDF, eccetera?

Nonostante &kdiff3; possa analizzare ogni tipo di file, probabilmente il risultato non sarà molto soddisfacente.

&kdiff3; è stato fatto per confrontare file di testo semplice. OpenOffice, Word, Excel eccetera memorizzano molte più informazioni nei file (sul tipo di carattere, le immagini, le pagine, i colori eccetera) di cui &kdiff3; non sa nulla. Quindi &kdiff3; ti mostrerà i contenuti del file interpretato come testo semplice, ma ciò potrebbe essere illeggibile, o almeno sembrerà molto strano.

Siccome la maggior parte dei programmi oggigiorno memorizza i contenuti in formato XML, dovresti poterli leggere come testo semplice. Quindi se c'è stato solo un piccolo cambiamento, &kdiff3; potrebbe ancora essere d'aiuto.

La migliore soluzione se vuoi solo confrontare il testo (senza oggetti integrati, come le immagini) è usare Seleziona tutto e Copia nel programma per copiare il testo rilevante negli appunti, e in seguito incollare il testo in &kdiff3; in una finestra di confronto. Vedi anche la sezione seleziona, copia e incolla.

Dov'è andata l'opzione delle cartelle Elenca solo le differenze?

Ora ci sono varie opzioni di visualizzazione nel menu delle cartelle. Disabilitare Mostra file identici produce la stessa cosa che faceva l'abilitazione di Elenca solo le differenze.

Come faccio a fare una grande selezione nella finestra di ingresso delle differenze, visto che ci vuole così tanto tempo per lo scorrimento?

Comincia la selezione come al solito (fai clic e tieni premuto il &LMB;). Quindi usa i tasti di navigazione (Per esempio Pag↑ e Pag↓) tenendo premuto il &LMB;. Vedi anche la sezione seleziona, copia e incolla.

Qui ci sono molte informazioni, ma non hai trovato una risposta alla tua domanda?

Inviami la tua domanda. Ogni commento sarà apprezzato.

## Riconoscimenti e licenza

&kdiff3; - Strumento per confrontare e fondere file e cartelle

Copyright del programma 2002-2007 di Joachim Eibl joachim.eibl@gmx.de

Sono ben accette nuove idee e segnalazioni di errori da colleghi e da tutte le persone su Internet. Grazie!

Copyright della documentazione © 2002-2007 di Joachim Eibl joachim.eibl@gmx.de

Aggiornamento e revisione della traduzione (2020), attuale responsabile: Valter Mura valtermura@gmail.com

Aggiornamento e revisione della traduzione (2009): Federico Zenith federico.zenith@member.fsf.org

Aggiornamento e revisione della traduzione (2005): Andrea Celli

Traduzione 2004: Stelvio Rosset

&underFDL; &underGPL;

&documentation.index;